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PREFACE 


This manual provides information pertaining to the in¬ 
stallation of Control Data applications software under the 
following operating systems: 


• NOS 1 (Part I) 

• NOS/BE 1 (Part II) 

• SCOPE 2 (Part III) 


As a result, this handbook is divided into parts according 
to operating system. Since each system relates to 
unique installation and modification procedures, each 
part in the handbook contains its own introductory 
material. 
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INSTALLATION AND MODIFICATION 

Part I presents information pertaining to the installation 
of applications software under the Network Operating 
System Version 1 (NOS T M - 1). While the information in 
this part describes the application installation, users 
should reference the NOS 1 Reference Manual, Volume 1 
and the NOS Installation Handbook for additional informa¬ 
tion. 

Control Data assumes that the installation of applications 
software will be performed by an analyst with experience 
with a CDC® CYBER 70 or CDC® CYBER 170 series 
computer system. Control Data is not responsible for 
the proper functioning of undescribed features. 


RELEASE TAPES 


The following application products are available under 
NOS 1: 


Application 

Tape 

Section 

APEX-HI Out-of-Core 
System 1 

REL57B 

2 

APEX-III Mixed Integer 
Programming Option 

REL57C 

2 

APEX-m Matrix Reduction 
Option 

REL57D 

2 

APEX-III Parametric s 
Option 

REL57E 

2 

APEX-m Usage Package 1 

REL57F 

2 

APL 2 

REL60 

3 

APT IV 2 

PL59 

4 

GPSS V/6000 1.2 

REL50 

5 

IMSL 6 

REL63 

6 

LCGT/IGS 2 

REL56A 

7 

PERT/TIME 2 

REL52A 

8 

SIMSCRIPT II. 5 V4.2 

REL64 

9 


Application Tape Section 

TIGS 1 REL62A 10 

Tektronix 40IX Post 
Processor Option Under 

TIGS REL62B 10 

TOTAL Universal 1 REL54A 11 

TOTAL Universal 

Extended 1 REL54B 11 

TOTAL Universal 2 REL54C 11 

TOTAL Universal 

Extended 2 REL54D 11 

TOTAL/ATHENA REL58 12 

UNIPLOT 3 REL66 13 

CalComp 906 Post 
Processor Option 

Under UNIPLOT REL66A 13 

Houston Instrument 
BTC-7 Post Processor 

Option Under UNIPLOT REL66B 13 

Tektronix 40IX Post 
Processor Option 

Under UNIPLOT REL66C 13 

Usage Accounting Utility APO01N 14 

XEDIT 3 REL61 15 

PDS/MaGen REL65 16 


RELATED DOCUMENTATION 

The following manuals contain relevant information for 
the operating system or application products described 
in part I. 

Title Publication No. 

NOS 1 Installation Handbook 60435700 

NOS 1 Reference Manual, Volume 1 60435400 
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Title 


Publication No. 


APEX-HI Reference Manual 
APL 2 Reference Manual 
APT IV Internal Maintenance 
Specification 

APT IV Reference Manual 
Beginning Graphics User Guide 
GPSS V/6000 General Information 
Manual 

GPSS V User f s Manual 
IMSL Reference Manual 
LCGT/IGS Reference Manual 
LCGT/IGS User Guide 
PDS/MAGEN User Information Manual 
PERT/Time Reference Manual 
SIMSCRIPT n.5 User Information Manual 
SIMSCRIPT n. 5 Instant 
TIGS VI Reference Manual 
TOTAL/ATHENA User Information Manual 
TOTAL Universal Reference Manual 
UNIPLOT Reference/User Guide 
Usage Accounting Utility Reference 
Manual 

XEDIT 3 Reference Manual 
2550 Computer System Software 
Reference Manual CCP 1.0 


76070000 

60454000 

* 

17326900 

76077300 

84003900 

76078800 

SMD150043* 

76079100 

76077400 

84009900 

60133600 

84000460 

84000450 

60455940 

84000090 

7607 0300 

60454730 

84000440 

60455730 

74701200 


*These manuals may be ordered by title from Control Data Corporation, Software Manufacturing and Distribution, 
4201 North Lexington Avenue, St. Paul, Minnesota 55112. 
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APEX-III OUT-OF-CORE SYSTEM 1 installation parameters 


RELEASE DESCRIPTIONS 

APEX-III Out-of-Core System 1 runs under NOS. The 
FORTRAN Extended compiler is required for compiling 
and updating APEX-III. APEX-III Out-of-Core System 1 
is designed to execute from permanent files. 

Hardware Requirements 

APEX-III Out-of-Core System 1 requires the same mini¬ 
mum hardware configuration as NOS. A minimum field 
length of 64K octal is required to execute APEX-III and 
70K octal is required for installation. 

Deficiencies 

None. 


None. 


INSTALLATION PROCEDURE 

APEX-ni Out-of-Core System 1 is installed by executing 
deck APEXC1, contained on the first file of REL57B. This 
job deck reads the APEX-III system from REL57B, 
compiles the system, and installs an executable file of the 
APEX-III system on a permanent file named APEXIII with 
the password APEX. 

This job deck also creates three permanent files which are 
needed when one uses the APEX-III USER feature. 
(Reference the APEX-III Reference Manual for detailed 
information.) For those installations where the USER 
feature is used infrequently, it may be desirable to main¬ 
tain these three files on magnetic tape rather than perma¬ 
nent files. These three files are described below: 


Release Materials 

APEX-ni Out-of-Core System 1 resides on the tape known 
as REL57B. REL57B is a program library in UPDATE 
format for APEX-III Out-of-Core System 1. It has the 
following characteristics: 7-track (800 bits per inch 
[bpi]) or 9-track (800 or 1600 characters per inch [cpi]), 
binary recording mode, OOCAPEXIIIV1P1 as file ID in 
HDR1 label, and six files: 

File 1 - installation deck in UPDATE PL form, 

File 2 - empty. 

File 3 - empty, 

File 4 - source code in UPDATE PL form. 

File 5 - verification deck in UPDATE PL form, and 
File 6 - sample output from verification run. 

Listings of the installation deck (APEXC1) and the verifi¬ 
cation deck (APEXCV) may be obtained from REL57B by 
executing the following job: 


Name 

Password 

Contents 

APEXPL 

APEX 

Partial APEX-III source 
code. Contains APEX-III 
COMMON regions and sub¬ 
routines QBUFFER, QGET, 
QUSER, and QUSERDA. 

APEXOV 

APEX 

Relocatable binary code of 
APEX-III overlay drivers. 

APEXRL 

APEX 

Relocatable binary code of 
remaining APEX-III 
subroutines. 


For those installations which have purchased any of the 
APEX-III options, deck APEXC1 may also be used to install 
the APEX-III Out-of-Co re System 1 with any combination of 
the APEX-III Mixed Integer Programming Option (MIP), 
APEX-III Matrix Reduction Option, and APEX-III 
Parametrics Option. 


LIST, T50. 

USER. (Supply valid USER card.) 

LABEL(OLDPL,R, LOOCAPEXIIIV1P1, 

HY | 

D = { HD \ , VSN=APXOOC) 

PE j 


UPDATE (F, *=,L=7) 
SKIPF(OLDPL,4,17) 
UPDATE(F, *=, L=7, R) 
7/8/9 
6/7/8/9 


The deck APEXC1 contains UPDATE IF,DEF directives to 
simplify installation. The names used by these directives 
and their meaning when DEFINEd are as follows: 


Name 


MT 

Uses 

HD 

Uses 

PE 

Uses 


Effect on Installation Job 
7-track magnetic tapes. 

9-track, 800 cpi, magnetic tapes. 
9-track; 1600 cpi, magnetic tapes. 
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Name Effect on Installation Job 

MIP APEX-III Mixed Integer Programming Option 

is installed with APEX-III Out-of-Core 
System 1. 

RED APEX-III Matrix Reduction Option is installed 

with APEX-III Out-of-Core System 1. 

PAR APEX-III Parametrics Option is installed with 

APEX-III Out-of-Core System 1. 

APEXC1 may be extracted from REL57B and submitted for 
execution via the following job. Note that APEXCl re¬ 
quires a change for execution. A valid user card must be 
supplied. 


INST, T50. 

USER. (Supply valid USER card.) 

LABEL(OLDPL, R, L=OOCAPEXIIIV1P1, 

\ HY \ 

D= HD , VSN=APXOOC) 

l PE J 


UPDATE(Q, *==,D, 8) 

SUBMIT (COMPILE, B) 

7/8/9 

{ MT \ 

HD i 

PE ) 

=DE FINE MIP (If Mixed Integer Programming 


Option.) 

=DEFINE RED (If Matrix Reduction Option.) 
=DEFINE PAR (If Parametrics Option.) 

-D, APEXCl. 3 

USER. (Supply valid user card.) 

=C, APEXCl 

7/8/9 

6/7/8/9 


VER, T50. 

USER. (Supply valid USER card.) 

LABEL(OLDPL, R, LOOCAPEXIIIV1P1, 

HY I 

D= j HD | , VSN=APXOOC) 

l PE J 

SKIPF(OLDPL, 4,17) 

UPDATE (Q, *—,D, 8,R) 

SUBMIT(COMPILE, B) 

7/8/9 

=D, APEXCV. 3 

USER. (Supply valid USER card.) 

=C, APEXCV 

7/8/9 

6/7/8/9 

File 6 of REL57B can be copied to OUTPUT and used to 
validate correct execution of the verification run. 


APEX-III MIXED INTEGER PROGRAMMING 
OPTION (MIP) 

RELEASE DESCRIPTIONS 

The APEX-III Mixed Integer Programming Option runs 
under NOS when installed with APEX-III Out-of-Core 
System 1. The FORTRAN Extended compiler is required 
for compiling and updating APEX-III MIP. APEX-III MIP 
is designed to execute from permanent files. 


Hardware Requirements 

APEX-III MIP requires the same minimum hardware con¬ 
figuration as NOS. A minimum field length of 64K octal is 
required for execution and 70K is required for installation. 


Error Messages 

A nonfatal loader error will be encountered in loading the 
APEX-III system. The error message is of the form: 

NE4102///DUPLICATE ENTRY POINT NAME-EXIT 

PROGRAM NAME-FORSYS= 

LAST FILE ACCESSED - FORTRAN 

Errors of any other form should be investigated. 


Installation Verification 

The following job may be used to extract job deck APEXCV 
from REL57B and submit for execution to verify installa¬ 
tion of APEX-III Out-of-Core System 1. 


Deficiencies 

None. 


Release Materials 

The APEX-III Mixed Integer Programming Option resides 
on the tape known as REL57C. REL57C is a program 
library in UPDATE format for APEX-III Mixed Integer 
Programming Option. It has the following characteristics 
7-track (800 bpi) or 9-track (800 or 1600 cpi), binary 
recording mode, MIPAPEXIIIV1P1 as file ID in HDR1 
label, six files: 
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File 1 - not used, 

File 2 - empty, 

File 3 - empty, 

File 4 - source code in UPDATE PL form, 

File 5 - verification deck in UPDATE PL form, and 
File 6 - sample output from verification run. 

A listing of the verification deck (APEXMV) may be 
obtained from REL57C by executing the following job: 

LIST, T50. 

USER. (Supply valid USER card.) 

LABEL(OLDPL, R, L=MIPAPEXIIIV1P1, 

j HY I 

D= | HD > , VSN=APXMIP) 

l PE ) 

SKIPF(OLDPL, 4,17) 

UPDATE(F, *=, L=7,R) 

7/8/9 

6/7/8/9 


INSTALLATION PARAMETERS 

None. 


INSTALLATION PROCEDURE 

The APEX-III Mixed Integer Programming Option must 
be installed with APEX-III Out-of-Core System 1. The 
installation deck, APEXC1, on the APEX-III Out-of-Core 
System 1 tape, known as REL57B, is used to install the 
MIP Option. The name MIP is defined for the UPDATE 
IF,DEF directives in deck APEXC1 to merge the MIP 
Option with the out-of-core s\^stem. 

Reference ’’Installation Procedure’’ for APEX-III Out-of- 
Core System 1 for details of installation and expected 
error messages. 

Installation Verification 

The following job may be used to extract job deck 
APEXMV from REL57C and submit for execution to verify 
installation of the MIP Option. 

VER, T50. 

USER. (Supply valid USER card.) 

LABEL(OLDPL, R, L=MIPAPEXIIIV1P1, 

HY | 

D= { HD | , VSN=A PXMIP) 

l PE ) 

SKIPF(OLDPL,4,17) 

UPDATE(Q, *~,D, 8, R) 

SUBMIT(COMPILE, B) 

7/8/9 

=D, APEXMV. 3 

USER. (Supply valid USER card.) 

=C, APEXMV 

7/8/9 

G/7/8/9 

File 6 of REL57C can be copied to OUTPUT and used to 
validate correct execution of the verification run. 


APEX-III MATRIX REDUCTION OPTION 
(REDUCE) 

RELEASE DESCRIPTIONS 

The APEX-III Matrix Reduction Option runs under the NOS 
operating system when installed with APEX-III Out-of-Core 
System 1. The FORTRAN Extended compiler is required 
for compiling and updating APEX-III REDUCE. APEX-III 
REDUCE is designed to execute from permanent files. 


Hardware Requirements 

APEX-III REDUCE requires the same minimum hardware 
configuration as NOS except that a minimum field length of 
64K is required for execution and 70K octal is required 
for installation. 


Deficiencies 

None. 


Release Materials 

The APEX-III Matrix Reduction Option resides on the tape 
known as REL57D. REL57D is a program library in 
UPDATE format for APEX-III Matrix Reduction Option. 

It has the following characteristics: 7-track (800 bpi) or 
9-track (800 or 1600 cpi), binary recording mode, 
REDAPEXIIIV1P1 as file ID in HDR1 label, six files: 

File 1 - not used. 

File 2 - empty, 

File 3 - empty, 

File 4 - source code in UPDATE PL form, 

File 5 - verification deck in UPDATE PL form, and 
File 6 - sample output from verification run. 

A listing of the verification deck (APEXRV) may be ob¬ 
tained from REL57D by executing the following job: 

LIST, T50. 

USER. (Supply valid USER card.) 

LABEL(OLDPL, R, L=REDAPEXIIIVIP 1, 

| BY T 

D= HD , VSN=APXRED) 

SKIPF(OLDPL, 4,17) 

UPDATE(F, *==, L=7,R) 

7/8/9 
6/7/8/9 


INSTALLATION PARAMETERS 

None. 


INSTALLATION PROCEDURE 

The APEX-III Matrix Reduction Option must be installed 
with APEX-III Out-of-Core System 1. The installation 
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deck, APEXC1, on the APEX-III Out-of-Core System 1 
tape, known as REL57B, is used to install the REDUCE 
Option. The name RED is defined for the UPDATE IF,DEF 
directives in deck APEXC1 to merge the REDUCE Option 
with the out-of-core system. 

(Reference "Installation Procedure" for APEX-III Out-of- 
Core System 1 for details of installation and expected 
error messages.) 

Installation Verification 

The following job may be used to extract job deck APEXRV 
from REL57D and submit for execution to verify installa¬ 
tion of the REDUCE Option. 

VER, T50. 

USER. (Supply valid USER card.) 

LABEL(OLDPL, R, L=REDAPEXIIIV1P1, 

I HY \ 

D= { HD > ,VSN=APXRED) 

l PE ) 

SKIPF(OLDPL,4,17) 

UPDATE (Q, *=,D, 8,R) 

SUBMIT(COMPILE, B) 

7/8/9 

=D, APEXRV. 3 

USER. (Supply valid USER card.) 

=C,APEXRV 

7/8/9 

6/7/8/9 

File 6 of REL57D can be copied to OUTPUT and used to 
validate correct execution of the verification run. 


APEX-III PARAMETRICS OPTION 


RELEASE DESCRIPTIONS 

The APEX-III Parametrics Option runs under the NOS 
operating system when installed with APEX-III Out-of- 
Core System 1. The FORTRAN Extended compiler is re¬ 
quired for compiling and updating APEX-III Parametrics. 
APEX-III Parametrics is designed to execute from 
permanent files. 


Hardware Requirements 

APEX-III Parametrics requires the same minimum hard¬ 
ware configuration as NOS except that a minimum field 
length of 64K octal is required for execution and 70K octal 
is required for installation. 


Release Materials 

The APEX-III Parametrics Option resides on the tape 
known as REL57E. REL57E is a program library in 
UPDATE format for APEX-III Parametrics Option. It has 
the following characteristics: 7-track (800 bpi) or 9-track 
(800 or 1600 cpi), binary recording mode, PARAPEXIIIV1P1 
as file ID in HDR1 label, six files: 

File 1 - not used, 

File 2 - empty, 

File 3 - empty, 

File 4 - source code in UPDATE PL form, 

File 5 - verification deck in UPDATE PL form, and 
File 6 - sample output from verification run. 

A listing of the verification deck (APEXPV) may be ob¬ 
tained from REL57E by executing the following job: 

LIST, T50. 

USER. (Supply valid USER card.) 

LABEL(OLDPL,R,L=PARAPEXIIIVlPl, 

/ HY I 

D= HD J , VSN=APXRED) 

l PE ) 

SKIPF(OLDPL,4,17) 

UPDATE(F, *=, L=7,R) 

7/8/9 

6/7/8/9 


INSTALLATION PARAMETERS 

None. 


INSTALLATION PROCEDURE 

The APEX-III Parametrics Option must be installed with 
APEX-III Out-of-Core System 1. The installation deck, 
APEXC1, on the APEX-III Out-of-Core System 1 tape, 
known as REL57B, is used to install the Parametrics 
Option. The name PAR is defined for the UPDATE IF,DEF 
directives in deck APEXC1 to merge the Parametrics 
Option with the out-of-core system. 

(Reference "Installation Procedure" for APEX-III Out-of- 
Core System 1 for details of installation and expected 
error messages.) 

Installation Verification 

The following job may be used to extract job deck APEXPV 
from REL57E and submit for execution to verify installa¬ 
tion of the Parametrics Option. 


Deficiencies 

None. 
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Deficiencies 


VER, T50. 

USER. (Supply valid USER card.) 

LABEL(OLDPL, R, L=PARAPEXIIIV1P1, 

j HY | 

D= { HD \ , VSN=APXPAR) 

l PE ) 

SKIPF(OLDPL, 4,17) 

UPDATE (Q, *=, D, 8, R) 

SUBMIT (COMPILE, B) 

7/8/9 

=D, APEXPV. 3 

USER. (Supply valid USER card.) 

=C, APEXP3 

7/8/9 

6/7/8/9 

File 6 of REL57E can be copied to OUTPUT and used to 
validate correct execution of the verification run. 


APEX-III USAGE PACKAGE 1 


RELEASE DESCRIPTIONS 


None. 


Release Materials 

APEX-III Usage Package 1 resides on the tape known as 
REL57F. REL57F contains relocatable binary code for 
APEX-III Usage Package 1. It has the following character¬ 
istics: 7-track (800 bpi) or 9-track (800 or 1600 cpi), 
binary recording mode, AUUAPEXIIIV1P1 as file ID in 
HDR1 label, seven files: 

File 1 - installation deck in UPDATE PL form, 

File 2 - relocatable binary code of APEX-III overlay 
drivers. 

File 3 - relocatable binary code of remaining APEX-III 
system routines, 

File 4 - partial source code in UPDATE PL form for 
USER feature, 

File 5 - verification deck in UPDATE PL form, 

File 6 - sample output from verification run, and 

File 7 - list file of documentation of selected APEX-III 
routines for USER feature. 


APEX-III Usage Package 1 runs under the NOS operating 
system. The FORTRAN Extended compiler is required 
for compiling APEX-III when using the USER feature. 
APEX-III is designed to execute from permanent files. 

Installation of APEX-III Usage Package 1 requires that the 
Usage Accounting Utility be installed and that a product 
update run be made to add the APEX-III product to the 
accounting files. (Consult the Usage Accounting Utility 
Reference Manual for further details.) 

The product activity card required for APEX-III has the 
following form: 



1 to 2 
3 to 12 
14 

16 


20 to 23 | 
25 to 28 ) 

30 to 80 


CD is the vendor code. 

APEX III is the product name. 

A signifies add product information to 
product name file. 

A signifies the product is active. 

4 is the ID value. 

Represent threshhold values-consult Usage 
Accounting Utility Reference Manual if 
usage of APEX-III is to be limited. 

APEX is the software code. 


Listings of the installation deck (APEXU1) and the verifica¬ 
tion deck (APEXUV) may be obtained from REL57F by 
executing the following job: 

LIST, T50. 

USER. (Supply valid USER card.) 

LABEL(OLDPL, R, L=AUUAPEXIIIV1P1, 

jf HY I 

D= HD , VSN=A PXAUU) 

l PE ) 

UPDATE(F, *==, L=7) 

SKIPF(OLDPL, 4,17) 

UPDATE(F, *==, L=7,R) 

7/8/9 
6/7/8/9 


INSTALLATION PARAMETERS 

None. 


INSTALLATION PROCEDURE 

APEX-III Usage Package 1 is installed by executing deck 
APEXU1, contained on the first file of REL57F. This job 
deck reads relocatable binary code of the APEX-III system 
from REL57F and installs an executable file of the 
APEX-III system on a permanent file named UAPEX3 with 
the password APEX. 


This job deck will optionally create three permanent files 

Hardware Requirements which are needed when one uses the APEX-III USER 

feature. (See the APEX-III Reference Manual for detailed 

APEX-III Usage Package 1 requires the same minimum information.) For those installations where the USER 

hardware configuration as NOS except that a minimum field feature is used infrequently, it may be desirable to refer- 

length of 70K octal is required for execution of APEX-III. ence these files directly from the installation tape when 


76071100 N 


1-2-5 



needed rather than maintaining them on permanent files. 
These three files are described as follows: 

Name Password Contents 

UAPEXPL APEX Partial APEX-III source 

code. Contains APEX-III 
COMMON regions and sub¬ 
routines QBUFFER, QGET, 
QUSER and QUSERDA. Same 
as file 4 of installation tape. 

UAPEXOV APEX Relocatable binary code of 

APEX-III overlay drivers. 
Same as file 2 of installation 
tape. 

UAPEXRL APEX Relocatable binary code of 

remaining APEX-III sub¬ 
routines. Same as file 3 of 
installation tape. 

The deck APEXU1 contains UPDATE IF,DEF directives to 
simplify installation. The names used by these directives 
and their meaning when DEFINED are as follows: 

Name Effect on Installation Job 

MT Uses 7-track magnetic tapes. 

HD Uses 9-track, 800 cpi magnetic tapes. 

PE Uses 9-track, 1600 cpi, magnetic tapes. 

PF Files 2, 3, and 4 of the installation tape are 

installed as permanent files with names 
UAPEXOV, UAPEXRL, and UAPEXPL re¬ 
spectively for the USER feature. 

APEXU1 may be extracted from REL57F and submitted for 
execution via the following job. Note that APEXU1 requires 
a change for execution. A valid USER card must be 
supplied. 

INST.T50. 

USER. (Supply valid USER card.) 

LABEL(OLDPL,R,L=AUUAPEXIIIVlPl, 

/ HY | 

D= HD , VSN=APXAUU) 

l PE ) 

UPDATE(Q, *==,D, 8) 

SUBMIT (COMPILE, B) 

7/8/9 


{ MT \ 

HD | 

=DEFINE PF (If files for USER feature are to be 
on permanent files.) 

=D, APEXU1. 3 

USER. (Supply valid USER card.) 

=C, APEXU1 
7/8/9 
6/7/8/9 


Error Messages 

A nonfatal loader error will be encountered in loading the 
APEX-III system. The error message is of the form: 

NE4102///DUPLICATE ENTRY POINT NAME - EXIT 

PROGRAM NAME-FORSYS= 

LAST FILE ACCESSED- FORTRAN 

Errors of any other form should be investigated. 


Installation Verification 

The following job may be used to extract job deck APEXUV 
from REL57F and submit for execution to verify installa¬ 
tion of APEX-III Usage Package 1. 

VER, T50. 

USER. (Supply valid USER card.) 

LABEL(OLDPL,R, L=AUUAPEXIIIV1P1, 

I HY ) 

D= | HD > , VSN=APXAUU) 

( PE j 

SKIPF(OLDPL,4,17) 

UPDATE(Q, *==,D, 8,R) 

SUBMIT(COMPILE, B) 

7/8/9 

=D, APEXUV. 3 

USER, (Supply valid USER card.) 

=C, APEXUV 
7/8/9 
6/7/8/9 

File 6 of REL57F can be copied to OUTPUT and used to 
verify correct execution of the verification run. 


f| 

tj 
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RELEASE DESCRIPTION 


APL Version 2 runs under the NOS 1.3 time-sharing 
system or IAF, and as a NOS batch job. 

This installation procedure is designed to be run as a 
batch job by installation personnel. No knowledge of the 
APL language or APL terminals is required. 

NOTES AND CAUTIONS 

This installation procedure defaults to a time-sharing 
based system. If an IAF-based system is desired, 
the =DEFINE IAF directive is required whenever APL 
is assembled using the EXTRACT job. See step 3 on 
the following pages. 

This APL2 installation procedure destroys all existing 
files of the same name under user names APLO and APL1. 
(These permanent file names are listed as files and records 
in the Release Tape Format section.) The one exception 
to this procedure is when the =DEFINE APLDEBG is 
selected (see step 3); the running production version of 
APL is not disturbed (file APLDEBG is created instead 
of changing file APLPROD both of which reside under 
user name APLO). To access this new test version of 
APL, the user merely includes the DEBUG parameter as 
the last parameter on the APL control statement: 

APL, TT=. .., DEBUG. 

The validity of the APL system can be compromised and 
the security of locked proprietary functions in workspaces 
will be forfeited if the following information is disclosed to 
users: 

• Password on files APLPROD and APLDEBG, 

• Contents of file APLPL, and 

• The internal APL character representations 


INSTALLATION PROCEDURE 

The procedures for the installation of APL2 are outlined 
in the following seven steps. 

Step 1 - Validate User Names APLO and APL1 

The installation of APL2 requires that two user names be 
validated prior to actual installation. (Check to see if user 
names APLO and APL1 have been previously validated. If 


they have not, validate them.) APLO must be validated 
for system origin privileges if a new deadstart tape is 
built (see step 6). Recommended LIMITS for APLO and 
APL1 are shown in figure 1-3-1. The LIMITS shown 
for APLO assume the use of the BINARY or DISK 
installation directives (see step 3). If the SOURCE or 
IAF directive is selected, a higher value for the MS 
validation on LIMITS should be used or the assembly 
listing (file LASM) should be written directly to tape to 
avoid PRU LIMIT. 

Step 2 - Run the LIST Job 

The installation/maintenance job is file 1 on the release 
tape (see ’’Release Tape Format” section). It is used for 
the following functions: 

• Installing the APL system from either 7- or 
9-track tape, 

• Installing the APL system from the released binary 
or source code, 

• Generating an IAF-based system in place of the 
default time-sharing based system, 

• Writing the APL system tape files to permanent 
disk storage, 

• Installing the APL public workspaces on user 
name APL1, 

• Enabling the APL interpreter to be installed under 
user name APLO without disturbing the production 
processing, 

• Changing the character set and hardware terminal 
type defaults, 

• Changing or deleting the APL entry message that 
is displayed to users, and 

• Creating a procedure file called ANEWSYS that 
can be used in conjunction with a tape request to 
create a new tape of all files on the APL system. 

File 1 is a program library in UPDATE format with 
= (equals) as the master character, and contains all NOS 
jobs necessary to install and maintain APL. To perform 
these functions, two jobs, LIST and EXTRACT, must be 
executed. LIST is used to obtain an UPDATE COMPILE 
file listing of the installation/maintenance job. With this 
listing, you can determine the UPDATE directives needed 
to select the desired options. These directives are then 
applied when running the EXTRACT job which does the 
actual installation functions. 
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LIMITS 


LIMITS 


$LIMITS. 


$LI MlTS. 


APLO 


APL1 


AB =% 

AB = 


AB = 

" 9 

AB = 

* 

AB = 

“ > 

AB = 

9 

AB = 

" 1 

AB - 

9 

MT = 

3, 

MT - 

3, 

RP = 

2, 

RP = 

2, 

TL - 

UNLIMITED, 

TL = 

UNLIMITED, 

CM - 

2037B, 

CM = 

2037B, 

NF = 

56, 

NF - 

56, 

DB = 

10, 

DB = 

10, 

FC - 

UNLIMITED, 

FC = 

UNLIMITED, 

CS * 

3276B, 

CS = 

32768, 

FS = 

SYSTEM, 

FS = 

SYSTEM, 

PA = 

EVEN 

PA = 

EVEN 

R0 - 

SYSTEM, 

R0 - 

SYSTEM, 

PX - 

HALF 

PX = 

HALF 

TT - 

TTY 

TT = 

TTY 

TC - 

STANDARD , 

TC = 

STANDARD , 

IS ^ 

NULL 

IS = 

NULL 

MS = 

25088, 

MS = 

12800, 

DF = 

1008, 

DF = 

1008 , 

CC * 

UNLIMITED, 

CC = 

UNLIMITED, 

OF - 

12, 

OF = 

12, 

CP - 

UNLIMITED, 

CP = 

UNLIMITED, 

LP - 

UNLIMITED, 

LP = 

UNLIMITED, 

EC = 

0B, 

EC - 

0B, 

SL - 

UNLIMITED, 

SL = 

UNLIMITED, 

CN = 

" 9 

CN = 

* 9 

PN = 

9 

PN = 

: , 

DS * 

1024, 

DS = 

1024, 


AW = 00000000000000000555 

AW = 00000000000000000555 


READY. 


Figure 1-3-1. Validate LIMITS for User Names APLO and APL1 


Run the following LIST job to list the installation/ 
maintenance job: 

LIST. 

USER. (Any user name, password and family 

may be used here.) 

CHARGE. (Insert charge card, if required.) 
LABEL(OLDPL,R, F=I, L-APL2, 

{ D=HY | (7-track, 800 bpi.) 

D=HD > , VSN=REL60, PO=R) (9-track, 800 cpi.) 

D=PE ) (9-track, 1600 cpi.) 

UPDATE(F, *=, L=A1247, C=0) 

UNLOAD(OLDPL) 

6/7/8/9 

Step 3 - Select the Desired EXTRACT Job Directives 


=IDENT OPTIONS 
=D APLINST. 3,4 

USER (APLO, password, family) 

=D, 133,134 

USER(APL1,password, family) 


(Delete USER and 
CHARGE statements.) 
(Insert your password 
and family for APLO.) 
(Delete USER and 
CHARGE statements.) 
(Insert your password 
and family for APL1.) 


EXTRACT directives for all other installation options are 
as follows: 


One of the following directives must always be included 
to specify the format of the release tape: 


With each EXTRACT run, the following directives must 
always be included: 


1-3-2 


76071100 M 



-DEFINE HY 
-DEFINE HD 
-DEFINE PE 


(To select 7-track, 800 bpi tape.) 
(To select 9-track, 800 cpi tape.) 
(To select 9-track, 1600 cpi tape.) 


If the SOURCE task is selected, a time-sharing-based 
system full assembly of all decks will be made and the 
following permanent files are replaced: 


One of the following directives must always be included to 
select the desired installation task to be performed: 

-DEFINE BINARY (To install the time-sharing- 

base d ready-to-execute system.) 
-DEFINE DISK (To create disk files of the 

release tape.) 

-DEFINE SOURCE (To compile APL from source 
and install as time-sharing- 
based system.) 

-DEFINE IAF (To compile APL from source 

and install as IAF-based 
system.) 

One of the following directives must always be included 
whether the BINARY, the SOURCE, the IAF, or the 
DISK Option was selected above: 

-DEFINE APLPROD (To replace the production 
APL interpreter.) 

-DEFINE APLDEBG (To replace the test APL 
interpreter.) 

If the BINARY task is selected, the default system and 
associated files are installed. The following permanent 
files are replaced: 

APLLIB APLPL TAPLTST CLEARWS 
EMPTY APLNEWS CATALOG WSFNS 
FILESYS FILES2 TAPLWS NEWSF 

See the "Release Tape Format" section, file 2, for the 
list of defaults values the interpreter is released as. 

No further directives are allowed for the BINARY and 
DISK tasks except those explained in step 4. 

If the APLPROD directive is selected, the old production 
permanent file APLPROD is replaced with the new pro¬ 
duction system. 

If the APLDEBG directive is selected, the old test version 
permanent file APLDEBG is replaced with the new test 
system. 

If the DISK task is selected, all release tape files are 
installed user name APLO using file names given in the 
"Release Tape Format" section. If this option is used, the 
workspaces are all stored as separate records under one 
file named APLWS under APLO, rather than their normal 
APL1 location. The DISK option also creates a procedure 
file called ANEWSYS under APLO which can subsequently 
be used to generate a new tape of the APL system, if it 
should be revised by the site. When this option is used, 
no files get installed under user name APL1 and the APL 
verify test job is not run. 


APLLIB APLPL APL 

AWSFIX AFIFIX AOVFIX 

If the IAF task is selected, an IAF-based partial assembly 

will be made of only those decks with *EDIT directives in 
the file IAFMODS and the following permanent files are 
replaced: 

APLLIB APLPL APL 

AWSFIX AFIFIX AOVFIX 

The IAF task should not be selected if the user’s system 
is time-sharing system-based. 

If the SOURCE or IAF task is selected, the user should 
determine where the site’s NOS system OPL file is located. 
This is the file containing the NOS common decks and 
macros. The APL assembly will use, by default, the 
following control statement to access this file: 

ATTACH(OLDPL-OPL/UN=LIBRARY) 

If the user’s system OPL file has a name different than OPL, 
or a storage location different than user name LIBRARY, 
these defaults can be changed by using the following 
directives with the replacements for MYOPL and MYLIB: 

-D 274 

ATTACH (OLDPL-MYOPL/UN-MY LIB) 

If the SOURCE or IAF task is selected, no further directives 
are allowed except those explained in step 4. 

Step 4 - Select Directives to Change the Installation 
Defaults (Optional) 

This optional step selects directives to change the installa¬ 
tion defaults for character set, terminal type, and entry 
message. 

To change the default character set and hardware terminal 
type defaults, include the following directives: 

-DEFINE CHANGE (Override default options.) 

-D 104 (Delete CALL, CHANGE 

(OPT1-64,OPT2-TYPEP).) 
CALL, CHANGE(OPTl=cs, OPT2=ttopt) 

(Both OPT1 and OPT2 must 
be specified.) 

where: cs=64 (default) (Character set is 64.) 

=63 (Character set is 63.) 

ttopt=APLAS (Corresponds to the ASCII 

APL print definition in the 
NOS Reference Manual , 

Volume I, page I-A-2.) 
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=TYPEP (default) 

(ASCII APL typewriter 
pairing.) 

=BITPR (ASCII APL bit pairing.) 

=ASCII (Full ASCII (not APL).) 

=TTY33 (Teletype Model 33 

compatible.) 

--BATCH (CDC 512 Printer with ASCII 

print chain.) 

=BH501 (CDC 501 Printer.) 

=TTY38 (ASCII APL Teletype Model 

38 model numbers 3841/4EA, 
3841/4EG, 3851/6JA and 
3851/6JG.) 

=CORRE (2741 compatible terminal. 

User must use TERM, 
CORAPL or equivalent before 
entering APL.) 

=CD713 (Full ASCII-lowercase alphas 

equate to uppercase alphas.) 

Note that although TYPEP is the default terminal type, 
many installations may be better off with APLAS, BITPR 
or CORRE. Consult your local APL analyst as to the 
most used type of APL terminal at your site. 

NOTE 

Even if a different default for the terminal 
type is preferred, it is not necessary to make 
the change since the APL user can specify the 
desired terminal type on the APL control 
card. 

To change the APL entry message that is displayed to 
users, include the following directives (the default is no 
entry message): 

-DEFINE CHANGE 

-DEFINE ENTRY 

=D 322 (Delete ENTER )LOAD *APL1 

APLNEWS. ) 

ENTRY MESSAGE OF YOUR CHOICE 

(Insert the desired message 
here - 80 character 
maximum.) 

To delete the APL entry message, include the following 
directives: 

=DE FINE CHANGE 

-DEFINE NOENTRY (Default is no entry message.) 

The CHANGE directive need only be specified once if you 
want to change both the entry message and default options. 
However, all other directives are still needed. 

The CHANGE directives, if specified, must be specified 
for all EXTRACT runs. That is, the 64-character set, 
TYPEP terminal type, and no entry message defaults are 
used unless otherwise specified by CHANGE directives. 


The CALL, CHANGE directive works by setting up a call to 
the program AOVFIX with the appropriate options. The 
default AOVFIX program statement is as follows: 

AO V FIX (C=64, L=OUT, FO=WSIO, TT=TYPEP) 

In general, the AOVFIX parameters are defined as follows: 

AOVFIX(C=cs, L=list, FO=WSIO, TT=ttopt,M=mfile,B=ovls) 

where: 

cs Defined in the CALL,CHANGE directive, 
ttopt Defined in the CALL,CHANGE directive, 
list The local file name to which the AOVFIX 
listing output is written. 

mfile The local file name containing the entry 
message. 

ovls The local file name to which the ready-to- 
execute APL interpreter is written. 

The FO=WSIO parameter must always be specified. If the 
M=mfile parameter is left out, no entry message will be 
generated which is what the =DEFINE NOENTRY directive 
does. If just M is specified, the file INPUT is used. If 
the B=ovls parameter is left out, AOVFIX writes the new 
interpreter to the file APLOVLS by default. 

Step 5 - Run the EXTRACT Job 

The EXTRACT job automatically creates and submits 
another job called APLO. The main function of job APLO 
is to create permanent files containing the APL interpreter 
and associated files under user name APLO. If the APLO 
job successfully completes and the BINARY, SOURCE, or 
IAF tasks were selected, job APLO, in turn, automatically 
creates and submits a job called APL1. The primary 
function of the APL1 job is to install the APL public work¬ 
spaces under user name APL1. When this is done, job 
APL1 automatically runs the APL batch test to provide 
output to be used when verifying the APL installation 
(see step 7). 

Run an EXTRACT job similar to the following with the 
desired installation options selected: 

EXTRACT. 

USER. (Any user name, password, and 

family may be used here.) 

CHARGE. (Insert charge card, if required.) 

LABEL(OLDPL, F=I,L=APL2, 

( D=HY | (7-track, 800 bpi.) 

| D=HD | VSN=REL60,PO=R) (9-track, 800 cpi.) 

I D=PE ) (9~track, 1600 cpi.) 

UPDATE(F, *==,C,D,8) 

UNLOAD(OLDPL) 

SUBMIT(COMPILE) 

RE WIND(COMPILE) 

COPYSBF(COMPILE) 

7/8/9 
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-IDE NT USERS (Include with all EXTRACT jobs.) 

-D APLINST. 3,4 

USER (APLO, password, family) 

(Insert APLO password and family.) 
CHARGE. (Insert charge card, if required.) 

=D 133,134 

USER (APL1,password, family) 

(Insert APL1 password and family.) 
CHARGE. (Insert charge card, if required.) 

=/ END OF USERS 
-IDENT OPTIONS 

I 

Insert your options or any of option sets listed in 
Table 1-3-1. 

6/7/8/9 

TABLE 1-3-1. TYPICAL EXTRACT JOB 
DIRECTIVE SETS 

Install time-sharing system-based APL test binaries 
using normal defaults from a 9-track, 800 cpi tape: 

=/ EXAMPLE OPTION SET 1. 

=DEFINE BINARY 
-DE FINE HD 
-DEFINE APLDEBG 
=/ END OF SET 1. 

Install time-sharing system-based production binaries from 
a 9-track, 1600 cpi tape and change the entry message: 

=/ EXAMPLE OPTION SET 2. 

-DE FINE PE 
-DEFINE BINARY 
-DE FINE CHANGE 
-DEFINE ENTRY 
-DE FINE APLPROD 
-D 322 

CHECK CATALOG FOR LATEST LIBRARY CHANGES. 
=/ END OF SET 2. 

Compile only IAF modifications and install APL as an 
IAF-based test system from a 7-track, 800 bpi tape: 

=/ EXAMPLE OPTION SET 3. 

-DEFINE HY 
-DEFINE IAF 
-DEFINE APLDEBG 
=/ END OF SET 3. 

Compile the entire time-sharing system-based APL sys¬ 
tem changing the terminal type default from TYPEP to 
BITPR and change the name of the NOS common decks 
file from OPL to SYSPL. 

=/ EXAMPLE OPTION SET 4. 

=DE FINE PE 
-DEFINE SOURCE 
-DEFINE CHANGE 
-DEFINE NOENTRY 
-DEFINE APLDEBG 
-D 274 

ATTACH(OLDPL-SYSPL/UN-LIBRARY) 

-D 104 

CALL, CHANGE (OPTl=64,OPT2=BITPR) 

=/ END OF SET 4. 


Step 6 - Install the APL Loader 

The final step in installing APL is to put the APL loader 
program on the deadstart tape. The loader is stored as 
private indirect access file called APL under user name 
APLO. It contains the entry points APL and APLUM 
which enable it to be accessed as a control statement under 
either name. 

To create a new deadstart tape, run a job similar to the 
following (the LIBEDIT directives may be different for 
your system): 

MAKEDST. 

USER(APL0,password, family) 

CHARGE. (Insert charge card, if required.) 

VSN(TAPE-tapenumber) 

(Insert volume serial number for 
new deadstart tape.) 

GET(APL) 

COMMON(SYSTEM) 

LIBEDIT(P-SYSTEM, B-APL, L-l, N-NE WSYS) 
REQUEST(TAPE, NT, PE, F-I, LB-KU, PO-W) 

COPY(NE WS YS, TAPE, V) 

UNLOAD(TAPE) 

7/8/9 

^DELETE ABS/APLSYS 

*BEFORE ABS/BASIC, ABS/APL 

(LIBEDIT directives.) 

6/7/8/9 

The NOS system should now be deadstarted again, using 
the newly created deadstart tape. (Refer to the NOS 
Installation Handbook, for the deadstart procedure.) 

Step 7 - Verify the APL Installation 

If the BINARY, SOURCE, or IAF EXTRACT job directive 
is selected, the APL batch test will be run automatically. 
The DAYFILE of job APL1 should show the message 
"*END OF VERIFY TEST” if the test ran to completion. 

The output from this test should be visually compared with 
file 6 (TAPLOUT) of the release tape. Any discrepancies 
may mean that the user has installed this version of APL 
on the wrong level of the operating system or may mean 
that the system has local modifications that are not com¬ 
patible with APL. 

The user may also wish to verify that APL runs correctly 
interactively. The following procedure can be run on 
any non-APL ASCII terminal: 

Log on to an interactive ASCII terminal using a user 
name other than APLO or APL1. 

Enter the command (where (6 r) means hit the carriage 
return key): 

APL, WS=APLNE WS, UN=APL1, TT=713 @ 

In response to the question WHAT DO YOU DESIRE? enter: 
ALL (rt) 
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When the printing stops, enter: 

© 

)SYSTEM (5r) 

This will exit APL and will return the user to the NOS 
command level. 

Although the APL batch test is run automatically during 
installation, the user may use the following job to run 
the test again without having to reinstall: 

VERIFY.RUN APL BATCH TEST 
USER (APL 1, password, family) 

(Run under user name APL1.) 
CHARGE. (Insert charge card, if required.) 

* VERIFY APL INSTALLATION 
ATTACH(TAPLTST/UN=APLO) 

COPYBR(INPUT, TAPLDIR) 

PURGE (OUTFILE/NA) 

DEFINE (OUTFILE) 

SETTL(4000) 

APL(I=TAPLTST, LOUTFILE, TT=BATCH, LO=EPB, 
DEBUG) 

RETURN(TAPLTST, OUTFILE) 

REWIND(TAPLDIR) 

APL(I=TAPLDIR, TT=BATCH, LO=PB, MX=100000B, 
DEBUG) 

* END OF VERIFY TEST 
EXIT. 

RE WIND(OUT FILE) 

COPY(OUTFILE) 

PURGE (OUTFILE, CLEAR WS, TSTEMP, TEST1, 
TEST2/NA) 

PURGE(COPYTST, PWTEST, ABC/NA) 

7/8/9 

)LOAD TAPLWS 
OUT $QTOUTFILE$QT 
)DROP OUTFILE 
6/7/8/9 

Note that the DEBUG parameter on the APL control 
statements should be included only if the user wishes to 
test file APLDEBG under user name APLO. File 
APLPROD is tested if the DEBUG parameter is omitted. 


RELEASE TAPE FORMAT 


The APL2 installation tape format is as follows: 

File 1 APLINST - OLDPL - contains all decks 

necessary to install and maintain the inter¬ 
preter under system library *APL0 and the 
public system oriented workspaces under 
library *APL1. 

File 2 APLPROD(pfn) or APLDEBG(pfn) or 

APLOVLS(lfn), OVL, and others - contain the 
absolute binary of the APL system set up for 
use (AOVFIXed). The released system has been 
generated for time-sharing usage and batch 
usage with the 64 character set. The default 


translation is APL-ASCII Typewriter-Pairing. 
If an IAF-based system is desired, see the 
=DEFINE IAF directive in step 3. 

File 3 APLLIB - REL and TEXT - contains the 

relocatable binaries of the APL system along 
with their associated overlay directives. 

This includes the APL loader, the AWSFIX 
program (which formats sequential workspace 
files into the form APL understands), the 
AFIFIX program (which formats sequential 
APL structured files into the form APL 
understands), and the AOVFIX program 
(which replaces the first record of APLPROD 
with user selected system defaults). 

File 4 APLPL - OPL - contains the source of the 
APL system in MODIFY format. 

File 5 TAPLTST - TEXT - contains negative and 
positive tests for verifying APL after it has 
been installed on the user’s system. The 
EXTRACT job automatically runs this test 
after installation. It tests most major 
features of the APL system. 

File 6 TAPLOUT - TEXT - contains sample demo 
output from running the TAPLTST which was 
described previously. 

File 7 APLWS - workspaces - contains the 
following records: 

Record 1 CLEARWS - workspace 

This workspace is supplied for 
compatibility with the APL 
reference manual and for 
$QDCOPY. Note that a )CLEAR 
command or $QDLOAD’*APLO 
CLEARWS’ no longer accesses 
this workspace but causes an over¬ 
lay to be loaded instead. 

Record 2 EMPTY - workspace 

See Section 12 of the APL 
Reference Manual. 

Record 3 APLNEWS - workspace 

When accessed, this workspace 
gives the user news about the 
APL system. See Section 11 of 
the APL Reference Manual. 

Record 4 CATALOG - workspace 

When accessed, this workspace 
guides the user to the various 
public libraries of APL workspaces 
that are installed on the user’s 
system. See Section 11 of the 
APL Reference Manual. 

Record 5 WSFNS - workspace 

Contains functions of general 
interest. 
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Record 6 


Record 7 


Record 8 


FILESYS - workspace File 8 

Contains convenient functions 
for use with the APL file system. 

See Section 10 of the APL 
reference manual. 

File 9 

FILES2 - workspace 

Contains more complex functions 

for use with the APL file system. 

See Section 10 of the APL 
reference manual. 

TAPLWS - workspace 
Contains all functions used when 
running the APL test; see File 5. 


NEWSF - APL Random Access File - 
contains the news file which is used by the 
APLNEWS workspace. See File 7, Record 

3. 

IAFMODS TEXT - contains the modsets that 
are used to create an lAF-based version of 
the APL system and are intended for usage 
with NOS 1.3. These modsets are auto¬ 
matically applied to the APLPL file when 
the =DEFINE IAF directive is included 
during the running of the EXTRACT job. 

See step 3. 
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APT IV 2 


4 


GENERAL DESCRIPTION 


INSTALLATION REQUIREMENTS 


APT IV is a numerical control language processor designed 
to generate cutter location coordinates. The user has the 
capability to fully describe the part to be machined and 
then drive the tool along the chosen path. The output from 
APT IV is a verification listing and a file for input to a 
post processor. APT IV V2 has all the capabilities of 
APT IV VI in addition to new language features and 
extensions. 

APT IV V2 runs under NOS 1 on a Control Data host 
computer having at least 65,000 words of central memory. 


RELEASE MATERIALS 


APT IV V2 for NOS 1 is contained on release tape PL59. 
The structure of PL59 is as follows: 

File 1 - contains the source library in UPDATE 
format. The first 67 decks, TAPEOP through 
ZSSPICT are common decks called by one or more 
of the succeeding decks. The next 16 decks, LLDM 
through LBCDBIN, are the LOAD COMPLEX. The 
next deck, LLCDATA, is data used by the LOAD 
COMPLEX routines. The next 93 decks, TAPT4T 
through TLCANON, are the TRANSLATOR. The next 
378 decks, XAPT4E through XTRANSF57 are the 
EXECUTION COMPLEX. The next 45 decks, CAPT4C 
through CTAPEWT are the CLEDITOR. The last 18 
decks, PAPT4P through PTAPEWT are the POST 
EXEC. 

File 2 - contains the relocatable binary records of all 
routines needed for the STANDARD mode. It in¬ 
cludes the binary records, COD4, PRD4, PTR4, 
P004, and C004, produced by the LOAD COMPLEX. 
This file is ready to be loaded by the host computer 
system and will produce the absolute modules con¬ 
tained on file 3. 

File 3 - contains the absolute modules of the APT IV 
V2 system. The file should be placed on the system 
library if the user does not wish to modify the APT 
IV V2 processor. File 2 of the release tape is used 
to make file 3. 

File 4 - contains the decks to install APT IV V2 on 
the host computer system. 

File 5 - contains three identical part programs. Job 
control cards are provided to verify correct opera¬ 
tion with system overlays resident in the system 
library, permanent files, or user library. User 
libraries with absolute modules are not currently 
available on NOS 1. 


The system has four general modes of operation: 

1. Standard mode - offers all capabilities except 
parametric and sculptured surfaces. This mode 
requires approximately 110,000g words of field 
length to build the system and for execution; 

2. Parametric surface mode - offers all capabilities 
of the standard system plus the added features of 
parametric surface processing. This mode does 
not include sculptured surface processing. Ap¬ 
proximately 110,000g words are required to build 
the system and (110, 000g plus the length of the 
FORTRAN parametric surface routines) words for 
execution; 

3. Sculptured surfaces mode - offers all capabilities 
of the standard system plus the added features of 
sculptured surface processing. This mode does 
not include parametric surface processing. Ap¬ 
proximately 125,000g words are required to build 
and execute the system; 

4. Parametric and sculptured mode - both parametric 
and sculptured surface processing may be used. 
Approximately 125,000g words are required to 
build the system and (125,000g plus the length of 

of the FORTRAN parametric surface routine) words 
for execution. 


INSTALLATION OPTIONS 

The user may choose one of four modes: 

1. standard 

2. parametric surface 

3. sculptured surface 

4. parametric and sculptured surface 

The release system operates in Standard mode. 

In addition to the above modes, the user may choose one 
of three residences for the APT IV system. These are: 

1. system library 

2. permanent files 

3. user library 

The released system operates from the system library. 
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INSTALLATION PROCEDURES 


The following control cards may be used to obtain the verifi¬ 
cation and installation decks from PL59: 

IBGET, MT1. 

L A BE L (GE T, R, L=A PT4 *R E LEASE) 
where RELEASE = NOS1PO 

SKIPF(GET, 3) 

COPYBF(GET, PUNCH, 2) 

6/7/8/9 

The following provides a description of all the installation 
decks included in file 4. The job name (MAPT41 - 
MAPT46) identifies the deck. 

• Install APT IV from file 3 of the release tape. 

Deck MAPT41 installs APT IV into the host 
computer operating system from file 3 of the re¬ 
lease tape. The first two files are skipped and 
the absolute modules of file 3 are copied to input 
files for the system library program. 

• Install APT IV from file 2 of the release tape. 

Deck MAPT42 may be used to make modifications 
to any routines except the LOAD COMPLEX. The 
modified routines are exchanged with their counter¬ 
parts on the supplied relocatable file, and the 
resultant file is installed on the host computer 
system. 

• Install APT IV from file 1 of the release tape. 

Deck MAPT43 and MAPT44 may be used to build 
the entire APT IV system from the source file. 

This will be necessary if the user wishes to install 
the sculptured surface and/or parametric surface 
mode of operation. The LOAD COMPLEX routines 
are compiled and executed. The output from 
LOAD COMPLEX is five FORTRAN block data 
programs which are then compiled and the relo¬ 
catable binaries are placed on the file LCBIN. 

The entire APT IV system (TAPT4T through 
PTAPEWT) is compiled and relocatable binaries 
are placed on APTBIN. The two files are merged 
to form the file APTLGO. This file is then input 
to the LOADER and the absolute overlay modules 
are placed in the overlay file APTOVL. The re¬ 
mainder of the control cards makes a new system 
release tape which may be used as input to deck 
MAPT41. 


INSTALLATION OPTIONS 


The user has the following two options: 

1. The user must insert an UPDATE directive card 
^DEFINE SSSURF to cause the sculptured surface 
routines to be compiled into the system. This 
card is present in deck MAPT43. 


2. The user must insert an UPDATE directive 

card *DEFINE PARSURF to cause the parametric 
surface routines to be compiled into the system. 
This card is present in deck MAPT43. 

Install APT IV from file 2 with overlay residence on 
permanent files. 

Deck MAPT45 may be used to modify the relocatable file 
so that the APT IV system overlays can reside on perma¬ 
nent files. This deck can be modified as noted with 
COMMENT cards for a relocatable file with or without 
sculptured surfaces defined. For purposes of this example, 
the standard and parametric modes are equivalent. 

The permanent files are defined, UPDATE is run with the 
overlay load parameter in deck TSUPERVT set equal to 0, 
the routine BEGINT is compiled and replaced on the re¬ 
locatable file. Each overlay deck is compiled so that the 
overlay will be placed on a separate file. The loader then 
produces absolute overlay modules on the permanent files 
which are saved for later use. 

Install APT IV from file 2 with overlay residence on a 
user library.* 

Deck MAPT46 may be used to modify the relocatable file 
so that the APT IV system overlays can reside on a user 
library. The deck can be modified as noted with COMMENT 
cards for a relocatable file with or without sculptured 
surfaces defined. For purposes of this discussion, the 
standard and parametric modes are equivalent. 

UPDATE is run with the overlay load parameter in deck 
TSUPERVT set equal to 7LAPT40VL. The routine 
BEGINT is compiled and replaced on the relocatable file. 
The loader then produces absolute overlay modules on the 
file AFTOVL which is used as input to the EDITLIB pro¬ 
gram. EDITLIB then creates a user library on file 
APT40VL. 

Install APT IV from file 2 with overlay residence on the 
system library. 

Deck MAPT42 may be used to install the system overlays 
since the release file has the overlay load parameter in 
deck TSUPERVT set equal to 6LSYSTEM. 


LOAD COMPLEX EXECUTION 


Deck MAPT47 may be used to modify the five relocatable 
decks produced by the LOAD COMPLEX. The names of 
the decks are COD4, PRD4, PTR4, P004, and G004. 
Once the user modifications are determined and inserted, 
deck MAPT47 compiles and executes LOAD COMPLEX 
routines LLDM through LBCDBIN. 

The deck LCCDATA, which has been modified by the user, 
is the input data for the LOAD COMPLEX execution. The 
output, five FORTRAN BLOCK DATA routines, is then 
compiled and the relocatable decks replace their counter¬ 
parts on file 2 of the system release tape. Deck MAPT42 
may then be used to install the system. 


*Not currently available on NOS 1. 
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VERIFICATION 

Deck MAPT48, MAPT49, or MAPT50 from file 5 should 
be used to verify that APT IV V2 has been correctly 


installed. Deck MAPT48 is used when the system over¬ 
lays reside on the host computer system library. Deck 
MAPT49 is used when the system overlays reside on 
permanent files. Deck MAPT50 is used when the system 
overlays reside on a user library. 
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GPSS V/6000 1.2 


5 


RELEASE DESCRIPTION 

HARDWARE REQUIREMENTS 

A minimum field length of 100K octal is required to load 
GPSS V 1.2. Once loaded, it requires a minimum field 
length of 45K octal to execute. Other requirements are 
the same as the minimum hardware configuration for 
NOS 1. 


RELEASE MATERIALS 


The release materials for GPSS V Version 1.2 are included 
on the release tape REL50. The release tape contains six 
files: 

File 1 - GPSS V installation job decks GPS1 and GPS2, 
also the verification job deck VGPS in UPDATE format. 
The master control character for this UPDATE file 
is an equal sign (=). 

File 2 - GPSS V preloaded absolute binaries. 

File 3 - GPSS V relocatable binaries. 

File 4 - GPSS V program library in UPDATE format. 

File 5 - sample GPSS V model which is used as input 
by the verification deck VGPS. 

File 6 - output from verification job VGPS. 


INSTALLATION PROCEDURES 

File 1 of REL50 contains the installation decks GPS1, 
GPS2, and the verification deck VGPS. 

GPS1 updates the GPSS V program library (file 4), 
reassembles the system, and creates a new REL50 in the 
same format as the original release REL50. GPS1 may 
be used to configure the original release REL50 for a 
particular installation and also to install PSR corrective 
code. 

GPS2 installs the preloaded absolute binaries on a direct 
access permanent file named GPSS. GPSS V is intended to 
run from a local file. It cannot be executed from the 
running system. The local file name for GPSS V must 
be GPSS. 


VGPS attaches the direct access permanent file GPSS and 
executes the model on file 5 of REL50. Output from VGPS 
should be similar to the output on file 6 of REL50. 

GPS1, GPS2, or VGPS may be obtained from REL50 by 
executing a job of the following form: 

EXTRACT, CM45000, T100. 

USER. (Supply valid USER card.) 

VSN(TAPE=REL50) 

( HY \ 

LABEL(TAPE , L=GPSSV1P2, F=SI, D= HD ) 

l PE ) 

UPDATE (Q, P-TAPE, *=, C-PUNCH) 

7/8/9 

-DEFINE X 

=/ UPDATE CARDS TO MODIFY INSTALL DECKS 
GO HERE. 

=C Y 
6/7/8/9 

where: 

X = HY or HD or PE 
Y = the deck name 

HY selects 800 bpi 7-track tapes 
HD selects 800 cpi 9-track tapes 
PE selects 1600 cpi 9-track tapes 

If a card punch is not available, or if the user desires to 
execute either GPS1, GPS2, or VGPS directly from REL50, 
the following two cards should be substituted for the UPDATE 
card in the previous deck: 

UPDATE(Q, P-TAPE, *==) 

SUBMIT(COMPILE, B) 

In order to list GPS1, GPS2, or VGPS as they appear on 
REL50, a job of the following form should be executed: 

LIST, CM45000, T100. 

USER. (Supply valid USER card.) 

VSN(TA PE -REL50) 

JHY | 

LABEL(TAPE , FI-GPSSV1P2, F=SI,D= < HD J ) 

l PE j 

UPDATE(Q, L=A 12347, *-=,P-TAPE) 

7/8/9 
=C GPS1 
=C GPS2 
=C VGPS 
6/7/8/9 
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INSTALLATION PARAMETERS 


Option 


Definition 


For maximum efficiency, several installation options are 
provided to configure GPSS V to individual installations. 

To select an option, an update *DEFINE option name card 
should be included in the configuration run. Options are: 

Option Definition 

CRM All I/O requests will be processed by 

the CYBER record manager. If not 
selected, standard CIO requests will 
be used. CYBER record manager will 
be used for I/O on the following files: 
INPUT, OUTPUT, JOBTA1, JOBTA2, 
and JOBTA3. All internal file opera¬ 
tions on files not available to the 
HELP block user still use CIO direct¬ 
ly for speed purposes. 

CP64 Code will be optimized for a 6400 type 

processor. If not selected, a 6600 
type processor is assumed. 

XJOP Monitor requests will be executed via 

the XJ instruction. If not selected, 
the XJ instruction is not used. 

IMUL Integer multiply hardware is installed. 

FILELOAD If defined, the preloader will create a 
random file containing the overlays. 
This version of GPSS cannot be placed 
on the system, but must be run from 
a permanent file. However, the field 
length required to start a GPSS run is 
reduced to what is needed to load the 
(0,0) overlay plus the longest primary 
overlay, which is about 30K instead 
of approximately 75 to 105K when 
FILELOAD is not defined. No ECS 
load options are available when 
FILELOAD is defined. 

REPRIEVE If defined, the error termination 
printout section is executed when 
GPSS execution is halted due to opera¬ 
tor drop, exceeding CP or I/O time 
limit, or exceeding mass storage 
limit. Thus, the results of the simu¬ 
lation up to the point at which GPSS 
execution is halted for one of the above 
reasons is printed. If REPRIEVE is 
not defined, GPSS execution is halted 
without an error termination printout. 

FTRACE If defined, then in addition to the 

standard one-line trace of GPSS V/ 
6000, the current transaction is also 
listed. This option slows down a simu¬ 
lation which uses the TRACE feature 
by a factor of 2 to 10 depending upon 
the amount of tracing done. It also in¬ 
creases the minimum field length for 
all runs by 2 to 3 K. 


LISALL If defined, LIST and UNLIST cards are 

listed on the output file when en¬ 
countered. Otherwise, they are never 
listed. 

CMR, XJOP, IMUL, and REPRIEVE are included by 
default in the install deck GPS1. 


Other parameters that may be changed for an installation 
are the operating system name and installation name. 
Cards of the following type may be used as input to 
update to change these parameters: 


*D, GPSSTXT .419. GPSSTXT. 42 0 
OPSYSTEM MICRO l,,$NOSl.X$ 

INSTALL MICRO 1,, $installation name$ 


CONFIGURATION RUN 

A job of the following form may be run to generate a new 
REL50 tape which is configured for a particular installation. 

CONFIG. CM45000,T100. 

USER. (Supply valid USER card.) 

VSN(TAPE=REL50) 

I HY \ 

LABEL(TAPE, FI=GPSSV1P2, F=SI, D= HD ) 

l PE j 

UPDATE(Q, *==,P=TAPE) 

SUBMIT(COMPILE, B) 

7/8/9 

=DEFINE X 
=D,GPS1.3 

=/ USER CARD GOES HERE 
=1, GPS1.50 

*D,GPSSTXT. 419,GPSSTXT. 420 
OPSYSTEM MICRO 1, ,$NOS l.X$ 

INSTALL MICRO 1,, $installation name$ 

LENGTH 
=C, GPSl 
6/7/8/9 


where: 

X = HY or HD or PE 


PSR MODIFICATION RUN 

A job of the following form may be run to update GPSS V 
with PSR corrective code and generate a new REL50. The 
PSR corrective code should be placed on a direct access file 
name USER previous to this run. 

I 
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PSR, CM45000, T100. 

USER. (Supply valid USER card.) 

VSN(TAPE=REL50) 

I HY i 

LA BEL (TAPE, FI=GPSSV1P2, F=SI, D= j HD > ) 

l PE ) 

UPDATE(Q, *==, P=TAPE) 

SUBMIT (COMPILE, B) 

7/8/9 

=DEFINE X 
=D, GPS1. 3 

=/ USER. (Supply valid USER card.) 

=I,GPS1.10 

ATTACH(USER) 

=D,GPS1.44, GPS 1. 51 
*READ USER 
=C, GPS1 
6/7/8/9 


where: 

X = HY or HD or PE 


NOTES AND CAUTIONS 

The deck GPSSTXT on the source OLDPL (file 4) of 
REL50 contains documentation which is an overview of the 
system. It is not required but may be helpful for the user 
to obtain a listing of GPSSTXT by assemblying it using 
COMPASS. 

When loading GPSS V, five nonfatal errors are noted. 
These errors are of the form: 

DUPLICATE ENTRY POINT NAME - INIT 

Errors of any other form should be investigated. 
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IMSL 6 


6 


RELEASE DESCRIPTION 


Step 1. Generate Essential Listings 


IMSL 6 (International Mathematical and Statistical Library, 
Version 6) consists of more than 400 FORTRAN functions 
and subprograms. IMSL 6 is on REL63. 


HARDWARE REQUIREMENTS 

IMSL 6 requires the minimum hardware configuration for 
NOS. 


NOTES AND CAUTIONS 

The installation process does not provide program listings. 
If a program listing is needed (it is very long), the FTN 
card in the install deck may be appropriately modified 
(remove L=0). 


RELEASE MATERIALS 


IMSL 6 is contained on the tape known as REL63. REL63 
is a program library in UPDATE format. It has the 
following characteristics: 7-track (800 bpi) or 9-track 
(800 or 1600 cpi), binary recording mode, F=SI, seven 
files: 

File 1 - install deck in UPDATE OLDPL format, 

File 2 - empty file, 

File 3 - empty file, 

File 4 - program deck in UPDATE OLDPL format, 

File 5 - verify job control language deck in UPDATE 
OLDPL format, 

File 6 - expected verify output ((COPYBF, OUTPUT) 
format), and 

File 7 - verify program deck in UPDATE OLDPL 
format. 


INSTALLATION PROCEDURES 

The procedure for the installation of IMSL 6 is outlined 
in the following four steps. 


This step includes: 

• Installation deck, 

• Verification deck, and 

• Expected verify output. 

NOTE 


The user must supply appropriate 
job and accounting cards. 

JOB. 

USER(*, *) 
CHARGED, *) 

( HY | 

LABEL(TAPE,D= 

< HD > , F=SI, VSN=IMSLIB) 

1 PE ) 


COPYBF(TAPE, OLDPL, 1) 

REWIND(OLDPL) 

UPDATE(F, D, 8, *=/, L=7) 

R E WIND (TAPE, OLDPL) 

SKIPF(TAPE, 4) 

COPYBF(TAPE, OLDPL, 1) 

RE WTND(T APE, OLDPL) 

UPDATE(F, D, 8, *=/, L=7) 

SKIPF(TAPE, 5) 

COPYBF(TAPE, OUTPUT, 1) 

6/7/8/9 

Step 2. Install IMSL 6 
Installation characteristics are: 

• Direct access permanent file, 

• Permanent file name = IMSLIB, 

• Public access rights, and 

• User number of the installer. 

JOB. 

USER(*, *) 

CHARGED,*) 

( HY I 

LABEL(TAPE,D= j HD > ,F=SI,VSN=IMSLIB) 

l PE J 

REWIND(TAPE, OLDPL) 

COPYBF(TAPE, OLDPL) 

REWIND(OLDPL) 

UPDATE(F,D, 8, *=/) 

SUBMIT(COMPILE, B) 

7/8/9 

/IDENX IMSL (Optional.) 

/DEFINE NOS (Required.) 
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Note that one of the following three tape parameters is 
required. 

/DEFINE MT (7-track, 800 bpi.) 

/DEFINE NT (9-track, 800 cpi.) 

/DEFINE NTPE (9-track, 1600 cpi.) 

/DELETE IMSLIL.XX, YY (Required.) 

USER(*, *) (Supply correct data for these 

cards.) 

CHARGED, *) 

6/7/8/9 

Step 3. Run Verification Tests 
Refer to the following. 

JOB. 

USER(*, *) 

CHARGED,*) 

( HY ) 

LABEL(TAPE, D= l HD } , F=SI, VSN=IMSLIB) 

i PE ) 

R E WIND(T APE, OLDPL) 

SKIPF(TAPE,4) 

COPYBF(TAPE, OLDPL) 


REWIND(OLDPL) 

UPDATE(F, D, 8, *=/) 

SUBMIT (COMPILE, B) 

7/8/9 

/IDENT IMSL (Optional.) 

/DEFINE NOS (Required.) 

Note that one of the following three tape parameters is 
required. 

/DEFINE MT (7-track, 800 bpi.) 

/DEFINE NT (9-track, 800 cpi.) 

/DEFINE NTPE (9-track, 1600 cpi.) 

/DELETE IMSLVL. XX, YY (Required.) 

USER(*, *) (Supply correct data for these 

cards.) 

CHARGE(*, *) 

6/7/8/9 

Step 4. Verification 

Do a minimal visual comparision of the expected verify 
output and the actual verify output. 
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LCGT/IGS 2 


RELEASE DESCRIPTION 

LCGT/IGS V2 (Low Cost Graphics Terminal Interactive 
Graphics System Version 2) runs under NOS and Telex to 
provide both a remote interactive graphic capability in 
graphic mode and timesharing capability in interactive 
mode. 

The LCGT/IGS subroutines are callable from user applica¬ 
tion programs only under FORTRAN Extended, and provide 
the user with the capability of interacting with his program 
from the console using the keyboard and cross-hairs. 

The operation of LCGT/IGS V2 requires the installation of 
Telex and all other associated products with it under NOS. 


HARDWARE CONFIGURATION 

The minimum hardware configuration required by NOS and 
Telex is required to support the LCGT terminal. LCGT 
supports only asynchronous communications under NOS. 

NOTES AND CAUTIONS 

All limitations applicable to NOS and Telex also apply to 
LCGT/IGS V2. 

All subroutines in LCGT/IGS V2 are callable from user 
application programs in FORTRAN Extended only. 

Under Telex, the LCGT operates asynchronously in a TTY 
compatible mode at 110 or 300 bauds using a 103A modem. 


RELEASE MATERIALS 


LCGT/IGS is contained on the tape known as REL56A. 

REL56A is a program library in UPDATE format. It has 
the following characteristics: labeled, 7-track (800 bpi) 
or 9-track (800 or 1600 cpi), binary recording mode, 
LCGTIGSV2 as file ID in HDR1 label, F=SI, six files: 

File 1 - installation job program library. 

File 2 - empty, 

File 3 - empty, 

File 4 - program library of LCGT/IGS in UPDATE 
format, 


File 5 - verification Job Program Library, and 
File 6 - empty. 


INSTALLATION PROCEDURES 


The installation of LCGT/IGS V2 requires creation of a 
user library, LCGTVR2. The job required to install 
LCGT/IGS is released as an installation deck program 
library. Telex is required before attempting to utilize 
LCGT/IGS V2 but is not necessary for its installation. 

The installation job is file 1 on the release tape. This job 
is a program library in UPDATE format with = (equals) as 
the master character. A dummy USER card is a part 
of this job. The user should first perform an UPDATE 
run and list the compile file. As a part of the EXTRACT 
procedure, the user should modify the JOB/ACCOUNT 
cards appropriately for his installation. 

To obtain the installation job, execute a procedure of the 
form shown below: 

EXTRACT, T10,CM60000. 

USER. (Supply valid USER card.) 

LABEL(LCGT,R, F=SI, L=LCGTIGSV2, 

( HY \ 

D= HD , VSN-LCGTV2) 

{ PE J 

COPYBF(LCGT, OLDPL) 

UPDATE(F, *= =, C, D, 8) 

UNLOAD(LCGT) 

SUBMIT(COMPILE) 

7/8/9 

=IDENT,XXX 
=DE FINE, NOS 

{ MT | (7-track, 800 bpi.) 

^DEFINE, | NT > (9-track, 800 bpi.) 

{ NTPE ) (9-track, 1600 bpi.) 

=D, LCGT1. yyy (To change JOB and user cards 

USER. as needed.) 

COMPILE, LCGT1 
6/7/8/9 

File 5 is the verification job. This job is also in UPDATE 
format and may require changes in the JOB/USER cards of 
the deck. A preliminary UPDATE run should be made and 
this deck listed for inspection. 

To save the binary of the verification job, the following 
XTRACT procedure can be used: 
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XTRACT, T10. 

USER. (Supply valid USER card.) 

LABEL(LCGT,R, F=SI, L-LCGTIGSV2, 

( HY \ 

D= | HD > , VSN-LCGTV2) 

l PE ) 

SKIPF(LCGT, 4,17) 

COPYBF(LCGT, OLDPL) 

UPDATE(F, C, D, 8) 

SUBMIT (COMPILE) 

7/8/9 

-IDE NT, XX 
-DEFINE, NOS 

-D,LCGT2.yyy (To change JOB and USER cards 

USER. as needed.) 

-COMPILE, LCGT2 
6/7/8/9 


VERIFICATION PROCEDURE 

The verification program, VRFY, is created as a perma¬ 
nent file as described earlier. This program can be run 
to verify the proper installation of LCGT/IGS as follows: 

1. Follow the "Terminal Operating Procedures” to 
set up the terminal for asynchronous operation. 

2. LOGIN with valid username and password, and 
proper CHARGE number. 

3. Execute the following procedure: 

NEW, CONTROL ( 0 ) 

TEXT 0) 

ATTACH(VRFY) 

ATTACH(LCGTVR2) 

FILE (TAPE62,BT=I,RT=S) 
LDSET(LIB=LCGTVR2, FILES=TAPE62) 

(Break Key) EXIT TEXT MODE. 

PACK 0 

SAVE,CONTROL 0 

-CONTROL or CALL, CONTROL 

4. You will be asked to enter terminal type 
(figure 1-7-1). 

1 - 4010 synchronous 

2 = 4010 asynchronous 


3 = 4014 synchronous 

4 - 4014 asynchronous 

5 - 4014 with EGM, synchronous 

6 - 4014 with EGM, asynchronous 

5. The screen will be cleared and figure 1-7-2 will 
be displayed on the screen. 

6. Type in any number in the range 5 through 25 

followed by . 

7. Figure 1-7-3 resulted by typing in 13. 

8. Type BYE when finished. 


TERMINAL OPERATING PROCEDURES 


LCGT can properly communicate with the following two 
types of ports on a 6671 or 6676 multiplexer under Telex. 

1. ASCII, asynchronous mode at 110 baud rate, and 

2. ASCII, asynchronous mode at 300 baud rate. 

To operate the terminal: 

1. Turn the terminal power on by pressing the 
POWER switch to the ON position. The POWER 
lamp will come on red. 

2. Set the ASCII/BCD switch to the ASCII position. 

3. Set the baud rate switch to one of the following 
positions: 

• 300 position if asynchronous at 300-baud 
rate. 

• PROG position if asynchronous at 
110-baud rate. 

4. Turn the CODE EXPANDER switch OFF. 

5. Dial the appropriate phone number. 

6. Telex will then send a LOGIN message when it is 
ready for interactive command processing. 
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ENTER TERMINAL TYPE, X THRU 6 



Figure 1-7-1. Entering Terminal Type 


ACCEPT 



Figure 1-7-2. Terminal’s Response 
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ACCEPT 



Figure 1-7-3. Result of Typing in a 13 


J 


1-7-4 


76071100 M 



PERT/TIME 2 
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RELEASE DESCRIPTION 


The following job installs PERT/TIME executable binary 
on a permanent file: 


HARDWARE REQUIREMENTS 

PERT/TIME requires up to three tape units and 65K central 
memory to run. 


RELEASE MATERIALS 

PERT/TIME is contained on release tape REL52A. 
REL52A is a program library in UPDATE format. It has 
the following characteristics: labeled, 7-track (800 bpi) 
or 9-track (800 or 1600 cpi), PERT2P0 as file ID in 
HDR1 label, six files: 

File 1 - installation deck program library in UPDATE 
format, 

File 2 - PERT/TIME in absolute binary format, 

File 3 - PERT/TIME in relocatable binary format, 
File 4 - source program library in UPDATE format, 
File 5 - empty, and 
File 6 - empty. 

LIMITATIONS 

No user file can be named TAPE1 through TAPE7 because 
these file names are used internally. 


JOB. 

USER. (Supply valid USER card.) 

VSN(TAPE=REL52A) 

LABEL(TAPE, FI=PERT2P0, F=I, 



DEFINE (PERT78/CT=S, M=R) 

SKIPF(TAPE, 1) 

COPYBF(TAPE, PERT78) 

6/7/8/9 

To execute from the release tape REL52A, run a job 
similar to the following: 

PERT, T1000, CM 10000. 

USER (usernumber, password) 
VSN(TAPE=REL52A) 

( MT I 

LABEL(TAPE, FI=PERT2P0, NT , 

I HY i 

D= HD ,F=I) 

l PE ) 

SKIPF(TAPE, 1) 

COPYBF(TAPE, PERT78) 

PERT78. 

7/8/9 

! | PERT networks 

6/7/8/9 


INSTALLATION PROCEDURES 


Release tape REL52A contains PERT/TIME. 


To get a listing and a punched-card copy of the installation 
decks from the first file of REL52A, run a job similar to 
the following (if a card punch is not on-line, the following 
decks should be keypunched): 


JOB. 

USER. (Supply valid USER card.) 

VSN(TAPE=REL52A) 

LABEL(TAPE, FI=PERT2P0, F=I, 

HY 

I I IVI ■ I' 1 

) 


D= 


HD 

PE 


MT 

NT 


UPDATE(F,L=A12347,P=TAPE) 
RE WIND (COMPILE) 
COPYBF(COMPILE, PUNCH) 
7/8/9 
6/7/8/9 


If a master data tape is made, insert the following after 
the LABEL statement: 

REQUEST, TAPE6,MT. 

In an old master data tape is input and a new master data 
tape saved, insert the following after the LABEL statement: 

REQUEST, TAPE4,MT. OLD MASTER 

REQUEST,TAPE6,MT. NEW MASTER 

If either option is used, insert a RESOURC statement 
before the REQUEST statement. An entry must be placed 
on the Y-card for each additional tape used. 
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Successive PERT/TIME networks may be processed by 
batching as follows (a higher FL will be required): 


The following job compiles and installs PERT/TIME from 
the source PL to a permanent file. 


K 

L 

M 

X 

Y 

W 

A PERT BATCHED NETWORKS 


• 

A 

Z 

K 

L 

• 

Z 

(Input for each network starts with the K control statement 
and ends with the Z control statement.) 


JOB. 

USER. (Supply valid USER card.) 

VSN(TAPE=REL52A) 


LABEL(TAPE, FI=PERT2PO, F=I, 



SKIPF(TAPE, 3) 

UPDATE(F, P=TAPE, R) 

UNLOAD(TAPE) 

REWTND(COMPILE) 

DEFINE (PERT78/CT=S,M=R) 
FTN(I=COMPILE, B=PERT, L=0) 
LOAD(PERT) 

NOGO(PERT78) 

7/8/9 

6/7/8/9 


MT 

NT ’ 
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SIMSCRIPT 11.5 VERSION 4.2 
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RELEASE DESCRIPTION 


INSTALLATION PROCEDURES 


SIMSCRIPT n.5 runs under NOS and is designed to 
execute from permanent files. 

HARDWARE REQUIREMENTS 

The SIMSCRIPT II.5 system requires the same minimum 
hardware configuration as NOS. The compiler requires 
a minimum 60K octal field length; however, core require¬ 
ments for compilation are dynamic and dependent on 
source program length. A 7OK octal field length is 
sufficient for most programs. 

DEFICIENCIES 

None. 

RELEASE MATERIALS 

SIMSCRIPT n.5 Version 4.2 is contained on the tape 
known as REL64. REL64 has the following character¬ 
istics: 7-track (800 bpi) or 9-track (800 or 1600 cpi), 
binary recording mode, SIMII5V4P2 as file ID in the 
HDR1 label and six files: 

File 1 - Installation deck INSTALL in UPDATE PL 
format. 

File 2 - Absolute binaries of the SIMSCRIPT II.5 
compiler. 

File 3 - Relocatable binaries of SIMSCRIPT n.5 
execution library and error messages. 

File 4 - empty 

File 5 - Verification deck in UPDATE PL format, and 
File 6 - Sample output from verification run. 

Listings of the installation deck and the verification 
program may be obtained by running the following job: 

LIST, T50. 

USER. (Supply valid USER statement.) (HYi 
LABEL(OLDPL, R, L=SIMII5V4P2, D= {HD > , 

VSN = REL64. (peJ 

UPDATE, F,* = =, L = 7. 

SKIPF, OLDPL, 4. 

UPDATE, F,*= = L = 7,R. 

6/7/8/9 


Installation deck INSTALL on file 1 of REL64 installs the 
SIMSCRIPT n.5 binaries on four permanent files: 

SIMII5 - SIMSCRIPT II. 5 compiler, 

SIM2LIB - SIMSCRIPT II.5 execution library, 

SIMERRC - SIMSCRIPT II.5 compiler error message 
file, and 

SIMERRE - SIMSCRIPT II.5 execution library error 
message file. 

SIMII5 and SIM2LIB are direct access files. SIMERRC 
and SIMERRE are indirect access files. 

The error message files must be SAVED under user name 
LIBRARY. This is because the SIMSCRIPT II.5 compiler 
or a running SIMSCRIPT II.5 program will attempt to 
GET these files internally from user’name LIBRARY, If 
the error message files do not exist, or are on a different 
user name, an error number is printed in the job dayfile, 
but no error message is printed. 

To execute INSTALL, a job of the following form should 
be run: 

INST, T50. 

USER. (Supply valid USER statement. 

LABEL, 0LDPL,R, L = SIMII5V4P2, D = 

VSN-REL64. 

UPDATE, Q,* = =,D, 8. 

SUBMIT, C0MPILE, B . 

7/8/9 | HY | 

= DEFINE |hd| 

(pe] 

=DELETE INSTALL.3 
USER. (Supply valid USER statement. 

= C0MPILE INSTALL 
6/7/8/9 


NOTES AND CAUTIONS 


PERMANENT FILES 

The installation deck on file 1 of REL64, INSTALL, does 
not check for existing permanent files with the names 
SIMII5, SIM2LIB, SIMERRC, or SIMERRE . If files 
already exist under these names, they must either be 
purged or renamed. 
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INSTALLATION VERIFICATION 


The following job may be run to verify correct installa¬ 
tion of the SIMSCRIPT II. 5 system: 


VERIFY, T50. 

USER. (Supply valid USER Statement.) I HYl 
LABEL, OLDPL, R, L=SIMII5V4P2, D= | HD > 

VSN=REL64. I PE j 

SKIPF, OLDPL, 4. 

UPDATE,Q,D, 8, *= =,R. 

SUBMIT, COMPILE, B. 

7/8/9 

=D VERIFY. 3 

USER. (Supply valid USER statement). 

=C VERIFY 
6/7/8/9 


File 6 of REL64 can be copied to OUTPUT and compared 
with the output from the submitted job to verify correct 
execution. 


• 1-9-2 
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TIGS 1 OVERVIEW 


RELEASE DESCRIPTION 

TIGS 1 (Terminal Independent Graphics System Version 
1) runs under NOS and either a time-sharing system or 
NAM/IAF communications package to provide the user 
with both a remote interactive graphic capability in graphic 
mode and a time-sharing capability in interactive mode. 

TEGS 1 consists of a preprocessor and a post processor. 
The preprocessor writes a neutral display file that is then 
traversed by the post processor to produce graphics 
output to a specific terminal. 

The TIGS subroutines are callable from user application 
programs that are coded in FORTRAN Extended. 

The operation of TIGS 1 under NOS requires the installa¬ 
tion of either the Time-sharing module or NAM/IAF and 
all associated products. 


HARDWARE CONFIGURATION 

The minimum hardware configuration required for NOS 
and the communications package (either the Time-sharing 
Module or NAM/IAF) is required to support TIGS 1. 

RELEASE MATERIALS 

The TIGS 1 release requires both the preprocessor mag¬ 
netic tape, REL62A, and an appropriate post processor 
tape. Refer to the individual post processor sections for 
installation, verification, and terminal operation of TIGS 

1 . 


TIGS 1 PREPROCESSOR 

The TIGS 1 preprocessor resides on the tape known as 
REL62A. REL62A has the following* characteristics: 
7-track (800-bits per inch (bpi)) or 9-track (800 or 1600- 
characters per inch (cpi)), binary recording mode, 
TTGSPREV1 as the file ID in the HDR1 label, and six 
files: 

File 1 - empty, 

File 2 - empty, 

File 3 - empty, 

File 4 - TIGS 1 preprocessor source code program 
library in UPDATE format, 

File 5 - empty, and 
File 6 - empty. 
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TEKTRONIX 401X POST PROCESSOR 
OPTION 


RELEASE MATERIALS 

The Tektronix 40IX post processor runs under NOS when 
installed with the TEGS 1 preprocessor. 

The Tektronix 401X post processor resides on the tape 
known as REL62B. REL62B is a program library in 
UPDATE format and has the following characteristics; 
7-track (800 bpi) or 9-track (800 or 1600 cpi), binary 
recording mode, TIGSTEKV1 as file ID in HDR1 label, 
six files: 

File 1 - installation job program library in 
UPDATE format, 

File 2 - empty, 

File 3 - empty, 

File 4 - TIGS 1 Tektronix post processor source 

code program library in UPDATE format, 
File 5 - verification job in UPDATE PL format, 
and 

File 6 - empty. 


NOTES AND CAUTIONS 

All limitations applicable to NOS and the communications 
package, (the Time-sharing Module or NAM/IAF) also 
apply to TIGS 1 with the Tektronix 40IX post processor. 

All TIGS 1 subroutines are callable from application pro¬ 
grams that have been written in FORTRAN Extended. 

A CDC Synchronous interface (Tektronix product number 
021-0135-01) is required on each Tektronix terminal to 
communicate in synchronous mode with the 255X host 
communications processor on NAM/IAF. 

Communications between the terminal and the central 
site are supported for TIGS 1 with the Tektronix 40IX 
post processor according to table I-10-1. 


TABLE 1-10-1. TIGS/TEKTRONIX COMMUNICATIONS 
CAPABILITIES 


Communications 

Communications 

Baud 

Compatible 

Mode 

Package 

Rate 

Modem Type 

Synchronous 

NAM/IAF 

4800 

208B 


NAM/IAF 

2400 

201B 


NAM/IAF 

2000 

201A 

Asynchronous 

NAM/IAF 

1200 

212A 


NAM/IAF and 
Time-sharing 

300 

103A 


1 - 10 - 1 © 



INSTALLATION DESCRIPTION 

The installation of TIGS 1 with the Tektronix 40IX post 
processor allows the user the option of generating either 
a segment/overlay loader library, TIGSLIB, or both a 
segment/overlay loader library, TIGSLIB, and a basic 
(nonsegment/nonoverlay) loader library, TIGSSFL. 

The segment/overlay loader library, TIGSLIB, can be 
used in those situations where memory requirements of 
graphic applications exceed the available NOS field length. 
The user can employ the segment/overlay loader library, 
TIGSLIB, in conjunction with the CYBER loader to segment 
or to overlay a graphic application and thereby reduce 
memory requirements. Note that the use of the segment/ 
overlay loader library, TIGSLIB, without segmentation 
or overlays greatly increases an application program 
field length requirement. 

The basic (nonsegment/nonoverlay) loader library, 
TIGSSFL, can be used for graphic applications with 
memory requirements that do not exceed the NOS avail¬ 
able field length. 


a 4800-baud hardware configuration, then specify an output 
buffer size of 8000 characters (=DEFINE, NOS8000). 

INSTALLATION PROCEDURE 

The procedure for installing TIGS 1 with the Tektronix 
401Xpost processor is outlined in the following three steps. 

Step 1 

The installation job is file 1 on the Tektronix post proc¬ 
essor release tape, (REL62B). File 1 is a program 
library in UPDATE format with = (equals) as the master 
control character. 

A dummy USER card has been included as part of the 
installation job. Perform an UPDATE run against file 
1 of REL62B and list the compile file to obtain the seq¬ 
uence number which corresponds to the USER card (and 
any other control cards) which must be modified for 
installation. A listing of the compile file may be ob¬ 
tained by executing the following procedure: 


The segment/overlay loader library, TIGSLIB, is install¬ 
ed by default by the installation job. Both the segment/ 
overlay loader library, TIGSLIB, and the basic (nonseg¬ 
ment/nonoverlay) loader library will be installed by the 
installation job by specifying =DEFINE,BASICLDR as 
an UPDATE directive. 

To provide optimum data output efficiency on NOS, the 
user must specify an output buffer size when installing 
TEGS 1 with the Tektronix 401X post processor libraries. 
Table 1-10-2 lists the selectable output buffer sizes and 
the factors which influence buffer size selection. 


TABLE 1-10-2. OUTPUT BUFFER SIZES 




Output Buffer 

Required 
Installation Job 

Baud 


Size in 

UPDATE 

Rate 

Condition 

Characters 

Directive 

300 

Field length is 
important 

concern. 

500 

=DEFINE, 

NOS500 

1200, 

2000 


1500 

^DEFINE, 

NOS1500 

1200, 

Much data is 

4000 

=DEFINE, 

2000, 

2400 

transmitted. 


NOS4000 

4800 


8000 

^DEFINE, 

NOS8000 


In general, if field length is not a primary concern and 
the libraries are to be used in a 300-baud hardware con¬ 
figuration, then define an output buffer size of 1500 char¬ 
acters (=DEFINE, NOS 1500). If the libraries are to be 
used in 1200-, 2000-, or 2400-baud hardware configura¬ 
tions, then specify an output buffer size of 4000 characters 
(=DEFINE, NOS4000). If the libraries are to be used in 


LISTI, T10, CM65000. 


USER(*) (Supply appropriate accounting 

information.) 

LABEL(TIGSPL, R, L=TIGSTEKV1, 

I HY | (7-t-ack, 800 bpi.) 

HD 1 ,VSN=REL62B,F=SI) (9-track, 800 cpi.) 
PE j (9-track, 1600 cpi.) 

COPYBF(TIGSPL,OLDPL) 

UNLOAD(TIGSPL) 

UPDATE(F, U, *= =, L=17) 

COP YSBF(COMPILE, OUTPUT) 

7/8/9 

=IDE NT, INSTALL 
=DE FINE, NOS 



{ hy I 

(7-track, 800 bpi.) 

DEFINE, 

j HD [ 

(9-track, 800 cpi.) 


1 PE J 

(9-track, 1600 cpi.) 


=DEFINE, BASIC LDR 

(This is an optional UPDATE direc¬ 
tive. If the user wishes to install 
both a segment/overlay loader 
library (TIGSLIB) and a basic (non¬ 
segment/nonoverlay) loader library 
(TIGSSFL), then this DEFINE state¬ 
ment must be included. If this 


=DE FINE, 


DEFINE statement is not included, 
then only the control cards required 
to install a segment/overlay loader 
library will be listed.) 

I NOS 500 \ 

NOS1500 I 
NOS4000 j 
NOS8000 * 


(Specify an output buffer size on 
NOS to improve the efficiency of 
the output of data.) 

6/7/8/9 


(1 
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Step 2 


Perform a full UPDATE on file 1 of the Tektronix post 
processor release tape, (REL62B), modifying the instal¬ 
lation job program library with the appropriate account¬ 
ing information and DEFINE UPDATE directives required 
for installation. Route the resulting installation job to 
the NOS input queue by executing the following procedure. 
NOTE: Only the Tektronix post processor release tape 
(REL62B) is required for the EXTRACT job, but both 
the Tektronix post processor release tape (REL62B) and 
the TIGS 1 preprocessor release tape (REL62A) are 
required for the installation job routed to the NOS input 
queue. 


EXTRACT, T10, CM65000. 

USER(*) (Supply appropriate accounting 

information.) 

LABEL(TIGSPL, R, L=TIGSTEKV1, 

HY \ (7-track, 800 bpi.) 


D= 


HD 

PE 


, VSN=REL62B, F=SI) (9-track, 800 cpi.) 

(9-track, 1600 cpi.) 


COPYBF(TIGSPL, OLDPL) 
UNLOAD(TIGSPL) 

UPDATE(F, *= =, L=T7, D, 8) 
ROUTE (COMPILE, DC=IN) 
7/8/9 

=IDENT, INSTALL 
=DEFINE, NOS 


| s 1 

* PF ' 


(7-track, 800 bpi.) 
(9-track, 800 cpi.) 
(9-track, 1600 cpi.) 


=DEFINE, 

' PE 

=DEFINE, BASICLDR 

(Optional UPDATE directive. If the 
user wishes to install both a segment/ 
overlay loader library (TIGSLIB) 


and a basic (nonsegment/nonoverlay) 
loader library (TIGSSFL), the 
=DEFINE, BASIC LDR directive must 
be included as part of the UPDATE. 
If the =DE FINE, BASIC LDR direc¬ 
tive is not included as part of the 
UPDATE, then only a segment/ 
overlay loader library (TIGSLIB) 
will be installed.) 


=DEFINE, 


{ NOS500 \ 
NOS1500 I 
NOS4000 | 
NOS8000 ‘ 


(Specify an output buffer size on 
NOS.) 

=D,TIGS1.XX (Modify the installation job program 

USER(*) library with appropriate accounting 

information. The dummy USER 
card sequence number, XX, was 
obtained from the COMPILE file 
listing resulting from step 1 of 
the ’’Installation Procedures”.) 

6/7/8/9 


ATTACH, A=TIGSLIB/PW=TEK 
SUI, 377776. 

DEFINE, B=TIGSLIB/UN=LIBRARY, CT=PU 
COPY, A, B, V. 

• If a basic (nonsegment/nonoverlay) loader 

library, TIGSSFL, was not generated by step 2 
of the ’’Installation Procedures,” then omit this 
step. 

Define the basic (nonsegment/nonoverlay) loader 
library, TIGSSFL, under user number LIBRARY: 

ATTACH, C=TIGSSFL/PW=TEK 
SUI,377776. 

DE FINE, D=TIGSSFL/UN=LIBRARY, CT=PU 
COPY, C, D, V. 


VERIFICATION PROCEDURE 


Use the following steps for verification: 
Step 1 


The verification job is file 5 on the Tektronix post proc¬ 
essor release tape, (REL62B). File 5 is a program lib¬ 
rary in UPDATE format with = (equals) as the master 
control character. 

A dummy USER card has been included as part of the 
verification job. Perform an UPDATE run against file 5 
of REL62B and list the COMPILE file to obtain the se¬ 
quence number which corresponds to the USER card (and 
any other control cards) which must be modified for in¬ 
stallation. A listing of the compile file may be obtained 
by executing the following procedure: 

LISTV, T10,CM65000. 

USER(*) (Supply appropriate accounting 

information.) 

LABEL (TIGSPL, R, L=TIGSTEKV 1, 

( HY \ (7-track, 800 bpi.) 

D= | HD ,VSN=REL62B,F=SI)(9-track, 800 cpi.) 

' PE ' (9-track, 1600 cpi.) 

SKIPF(TIGSPL, 4,17) 

COPYBF(TIGSPL, OLDPL) 

UNLOAD(TIGSPL) 

UPDATE(F,U, *= =,L=17) 

COPYSBF(COMPILE, OUTPUT) 

7/8/9 

=IDENT, VERIFY 
=DE FINE, NOS 
6/7/ 8/9 

Step 2 


Step 3 

Define the TIGS 1 library (or libraries) under user num¬ 
ber LIBRARY by entering the following commands at the 
NOS console. 

• Define the segment/overlay loader library, 
TIGSLIB, under user number LIBRARY: 


Perform a full UPDATE on file 5 of REL62B modifying 
the verification job program library with the appropriate 
accounting information and DEFINE UPDATE directives 
required for installation. Route the resulting verifica¬ 
tion job to the NOS input queue by executing a procedure 
of the following form: 
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XTRACT, T10, CM65000. 

USER(*) (Supply appropriate accounting 

information.) 

LABEL(TIGSPL,R, L=TIGSTEKV1, 

/ HY \ (7-track, 800 bpi.) 

D= I HD | , VSN=REL62B, F=SI) (9-track, 800 cpi.) 

I pe J (9-track, 1600 cpi.) 

SKIPF(TIGSPL, 4,17) 

COPYBF(TIGSPL, OLDPL) 

UNLOAD(TIGSPL) 

UPDATE(F, *==,L=17, D, 8) 

ROUTE (COMPILE, DC =IN) 

7/8/9 

=IDENT, VERIFY 
=DE FINE, NOS 

=D,TIGS2. YY (Modify the verification job program 
USER(*) library with appropriate accounting 

information. The dummy USER 
card sequence number, YY, was ob¬ 
tained from the compile file listing 
resulting from step 1 of the 
’’Verification Procedure.”) 

6/7/8/9 
Step 3 

Run the verification program, catalogued as permanent 
file VRFY by the verification job, to verify the proper in¬ 
stallation of TIGS 1. The verification program may be 
run as follows: 

1 . Refer to ’’Terminal Operating Procedures” 
section to properly set up the terminal. 

2. Log in to NOS with a valid family name, user 
name, password, and charge number. 

3. Create a procedure file by entering the following: 

NEW,SEGLIB 0) 

TEXT 0) 

ATTACH(VRFY) 0) 
ATTACH(TIGSLIB/UN=LIBRAR Y) 0) 

LDSE T (LIB=TIGSLIB) (0 
VRFY. 0) 

Depress BREAK key for the Time-sharing 
Module or press user break 2 key for IAF 
Computer responds with EXIT TEXT MODE. 
PACK 0) 

SAVE, SEGLIB 0) 

4. Call the SEGLIB procedure file which will 
execute the verification program, created in 
step 2 of the ’’Verification Procedure”, to verify 
the segment/overlay loader library, TIGSLIB, 
by the following: 

CALL,SEGLIB 

5. The terminal operator will be asked to enter the 
terminal type. Enter the number which cor¬ 
responds to the terminal type in use. (See 
figure I-10-1.) 


6. The terminal operator will be asked to enter the 
baud rate. Enter the baud rate that is in use 
(see figure 1-10-1). 

7. The terminal operator will be asked if the tablet is 
to be used (see figure 1-10-1). Enter N. The 
tablet is not required for the verification program. 

8. The terminal operator will be asked if a hardcopy 
unit is available (see figure 1-10-1). Enter N. 

The verification program does not require the 
availability of a hardcopy unit. 

9. The terminal screen will be cleared and figure 
1-10-2 will be displayed if terminal type 4, 5, 

6, or 7 was selected in step 5. Figure 1-10-3 
will be displayed if terminal type 2 or 3 was 
selected. Figure 1-10-4 will be displayed if 
terminal type 1 was selected. 

19. if terminal type 1 was selected in step 5, oper¬ 
ations 11 through 14 will be skipped. 

11* The operator is allowed to pick one of three 
buttons: WINDOW, RESTORE, or QUIT. The 
button is picked by moving the crosshairs over 
the text of the button and depressing an alpha 
key on the keyboard. 

12. if WINDOW is picked, the terminal operator will 
be asked to locate the lower-left and then the 
upper-right corner of a new window to display. 
This is done by moving the crosshairs to the 
appropriate corner and depressing the T key 

on the keyboard. When both corners have 
been located, the new window will be displayed. 

13. If RESTORE is picked, the original display will 
be displayed. 

14. If QUIT is picked, the verification program 
will terminate. 

15. If a basic (nonsegment/nonoverlay) loader 
library, TIGSSFL, was not installed, then go to 
operation 19. 

16. Create a procedure file to utilize the basic (non- 
segment/nonoverlay) loader library, TIGSSFL, 
by entering the following: 

NEW.SFLLIB 0) 

TEXT 0) 

ATTACH (VRFY) 0 
A TTACH (TIGSSFL/UN=LIBR AR Y) (0) 
LDSET(LIB=TIGSSFL) 0) 

VRFY. ^R) 

Press BREAK key for the Time-sharing 
Module or press user break number 2 
key for IAF. Computer responds with 
EXIT TEXT MODE. 

PACK 0) 

SAVE ,SFLLIB 0) 


• 1-10-4 
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ENTER TERMINAL TYPE 
1 4006 ASYNCHRONOUS 

3 4O10 SYNCHRONOUS 

3 4010 ASYNCHRONOUS 

4 4014 SYNCHRONOUS 

5 4014 ASYNCHRONOUS 

6 4014 U'EGN SYNCHRONOUS 

7 4014 LL'EGM ASYNCHRONOUS 
3 

ENTER BAUD RATE, 300 , 1200 , 2000 , 2400,4800 

3 

IS TABLET GOING TO BE USED (Y/N) 

N 

IS HARD COPY UNIT AUAILABLE (Y/N) 

N 


Figure 1-10-1. Terminal User is Asked to Enter Terminal Type, Baud Rate, if Tablet is to be Used, 

and if Hardcopy is Available 



WINDOW RESTORE QUIT 

Figure 1-10-2. Figure Displayed on Terminal Types 4, 5, 6, or 7 
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1. Turn the terminal power on. 


17. Call the SFLLIB procedure file which will exe¬ 
cute the verification program to verify the basic 
(nonsegment/nonoverlay) loader library, 
TTGSSFL, by the following: 

CALL, SFLLIB 

18. Repeat operations 5 through 14 to verify the 
basic (nonsegment/nonoverlay) loader library, 
TTGSSFL. 

19. Purge any unnecessary files generated during 
the installation or verification of TIGS 1. 

20. Log off the system by entering BYE when 
finished. 


TERMINAL OPERATING PROCEDURES 


TEKTRONIX 4006 TERMINAL 

The Tektronix 4006 terminal operating procedures are as 
follows; 

1. Turn the terminal power on by turning the POWER 
switch, located at the rear of the display unit, 

to the ON position. 

2. Allow the terminal to warm up. 

3. Press the PAGE key to erase the screen and to 
position the cursor to home position (the upper 
left-hand corner of the screen). 

4. Select the appropriate transmit and receive baud 
rates using the baud rate switches located at the 
rear of the display unit. 

5. The setting of the FULL/HALF DUPLEX 
switch located at the rear of the display unit is 
NOS installation dependent. 

6. Turn the modem power on and verify that the 
modem is connected to the terminal. 

7. Dial the appropriate telephone number. 

8. The Time-sharing Module will respond with a 
LOGIN message when ready for interactive 
command processing. NAM/IAF, however, 
requires the user to press the RETURN key 
after the terminal is polled before it will respond 
with a LOGIN message. 


TEKTRONIX 4010/4014 TERMINALS WITH 
SYNCHRONOUS INTERFACE 

The Tektronix 4010 and 4014 terminals (equipped with 
CDC synchronous interface) synchronous/asynchronous 
operating procedures are as follows: 


• Tektronix 4010 terminal: The POWER 
switch is located beneath the keyboard 
at the top of the pedestal stand. The red 
POWER indicator, located at the top of 
the keyboard, will illuminate when power 
has been applied to the terminal. 

• Tektronix 4014 terminal: The POWER 
switch is located on the front lower 
right-hand corner of the pedestal stand. 
The green POWER indicator, located on 
the upper left-hand corner of the key¬ 
board, will illuminate w r hen power has 
been applied to the terminal. 

2. Allow the terminal to warm up. 

3. Press the PAGE key to erase the screen and to 
position the cursor to home position (the upper 
left-hand corner of the screen). 

4. Set the ASCII/ALT switch to the ASCII position. 

5. Select the appropriate baud rate switch settings. 
The switch should select the EXT position if the 
terminal is to be used for synchronous communi¬ 
cations at 2000 and 4800 baud. Otherwise, the 
terminal baud rate switch setting will correspond 
to the baud rate in use. 

• Tektronix 4010 terminal: Select the ap¬ 
propriate transmit and receive baud 
rates using the baud rate switches 
located at the rear of the pedestal stand. 

• Tektronix 4014 terminal: Select the ap¬ 
propriate baud rate using the baud rate 
switch located at the rear of the pede¬ 
stal stand. 

6. The setting of the FULL/HALF DUPLEX switch 
is NOS installation dependent. 

7. Set the CODE EXPANDER switch to one of the 
following positions: 

• Synchronous mode communications: 

Turn the switch ON. 

• Asynchronous mode communications: 
Turn the switch OFF. 

8. The following keyboard operations establish 
proper operating mode: 

• Synchronous mode communications: 

Place the terminal in local mode. Press 
the SHIFT key. While the SHIFT key 

is pressed, press the RESET PAGE 
key. Place the terminal in line mode 
and repeat the keyboard procedure. 


76071100 R 


1-10-7 • 



• Asynchronous mode communications: 

Place the terminal in local mode. Press 
and keep depressed the SHIFT key. 

Press and keep depressed the CNTL 
key. While both the SHIFT and CNTL 
keys are pressed, press the P key. 

Place the terminal in line mode. 

9. Dial the appropriate telephone number. 

10. The Time-sharing Module will respond with a 
LOGIN message when ready for interactive 
command processing. NAM/IAF, however, 
requires the user to press the JRETURN key 
after the terminal is polled before it will 
respond with a LOGIN message. 


TEKTRONIX 4010/4014 TERMINALS WITHOUT 
SYNCHRONOUS INTERFACE 

If the Tektronix 4010 and 4014 terminals are not equip¬ 
ped with the CDC synchronous interface option, then 
the terminal can be operated in asynchronous mode 
only. 

The Tektronix 4010 and 4014 terminals asynchronous 
mode operating procedures are essentially the same as 
for the synchronous mode operating procedures. How¬ 
ever, step 8 of the synchronous mode operating proce¬ 
dures can be omitted. No special keyboard operations 
are required to establish mode switching since the 
terminals will always be in asynchronous mode when 
not equipped with the CDC synchronous interface option. 



• 1 - 10-8 
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TOTAL UNIVERSAL 1 


RELEASE DESCRIPTION 

TOTAL Universal 1 consists of the following relocatable 
binaries: 

DBGEN (Data base generation program) - this program 
reads user-prepared DBDL statements and generates 
COMPASS source statements which in turn produce the 
data base descriptor module. 

DBFMT (Data set format program) - this program reads 
format parameter statements, and, utilizing a data base 
descriptor module, preformats the data sets. 

DATBAS (Data base interface module) - this module 
serves as an interface between the user application pro¬ 
gram and the TOTAL and data base descriptor modules. 

TOTAL (Data base management module) - this module 
provides the data management capability of the system, 
interpreting and executing the various DML commands 
from the user application program. 

DBRCV (Data base recovery module) - this module, 
optional in use, provides the ability to recover record 
images from the TOTAL logging file. 

These files are to be installed on the user’s permanent 
file library (refer to the following section on ’’Installation 
Procedures”). 

Hardware Requirements 

TOTAL Universal 1 can be maintained and run on the same 
minimum hardware requirements as NOS 1. 

Deficiencies 

None. 


INSTALLATION PROCEDURES 

TOTAL Universal 1 resides on the tape REL54A. REL54A 
is a program library in binary format. It has the fol¬ 
lowing characteristics: labeled, 7- or 9-track, 800 bpi, 
binary recording mode, TOTALU1PO as file ID in HDR1 
label, six files: 

File 1 - installation and verification deck in UPDATE 
format, 

File 2 - empty, 

File 3 - five TOTAL relocatable binaries (described 
earlier), 


File 4 - empty, 

File 5 - empty, and 

File 6 - sample output of installation and validation 
job. 

Installation consists of the following steps: 

1. Determine update directives to modify the install 
deck (as described in the next section). 

2. Create the following job to call the install/ 
validate job from the install tape and submit it as 
a batch job: 

JOB/ACCOUNT. (Supply valid JOB/ 

ACCOUNT card.) 

LABEL, TOT, R, L-TOTALU1PO, DMIY, 
VSN-REL54A. 

UPDATE, O, *=$$$$, P-TOT, L=F. 

SUBMIT (COMPILE, B) 

7/8/9 

UPDATE directives 
6/7/8/9 

3. Validate the install validate job output against 
the sample output copied from the install tape. 


INSTALLATION PARAMETERS 

Following is a sample UPDATE directive deck to be used 
as described in the previous section. All options are 
shown and explained. 

SINST 

SCOMPILE INSTALL 

ISDEFINE MT | (7-track install tape.) 

ISDEFINE NT I (9-track install tape.) 

SDELETE INSTALL. 2, INSTALL. 3 
JOB/ACCOUNT. (Site/user dependent.) 


INSTALLATION JOB 

The installation/validation job performs the following: 

1. Issue LABEL to have install tapes assigned to job. 

2. DEFINE’s permanent file space for the five TOTAL 
files, and copies them from tape to the permanent 
files. An example of the DEFINE: 

DEFINE, DBGEN/CT-PU, M=R. 

3. Validation is begun by defining a data base using 
DBGEN. 

4. The test data base is formatted with DBFMT. 


76071100 N 


1 - 11-1 


5. Sample data is placed in the data base with a 
COBOL program, and retrievals are performed. 
DATBAS and TOTAL are verified in this phase. 

6. DBRCV is next run against the data base for its 
validation. 

7. Finally, the sample output of the install/validation 
job is copied from the install tape to output. 


TOTAL UNIVERSAL EXTENDED 1 

RELEASE DESCRIPTION 

TOTAL Universal Extended 1 resides on REL54B. 

REL54B is a program library in binary format. It has the 
following characteristics: labeled, 7- or 9-track, 800 
bpi, binary recording mode, eight files: 

File 1 (Installation deck) - this deck reflects the 
latest materials for each release level. The tape 
ID field shows the latest level number. 

File 2 - TOTAL (Data base management module) - 
this module provides the data mangement capability 
of the system, interpreting and executing the various 
DML commands from the user application program. 

File 3 - DATBAS (Data base interface module) - 
this module serves as an interface between the user 
application program and the TOTAL and data base 
descriptor modules. 

File 4 - DBGEN (Data base generation program) - 
this program reads user-prepared DBDL statements 
and generates COMPASS source statements which in 
turn produce the data base descriptor module. 

File 5 - DBFMT (Data set format program) - this 
program reads format parameter statements, and 
utilizing a data base descriptor module, preformats 
the data sets. 

File 6 - DBRCV (Data base recovery module) - 
this module, optional in use, provides the abilit} 7 to 
recover record images from the TOTAL logging file. 

File 7 - DATBASE (Data base interface module for 
transaction processing) - this module serves as an 
interface between the user application program and 
the TOTAL Universal Extended 1 and data base 
descriptor modules through TRANEX. 

File 8 - TOTALE (Data base management module 
for transaction processing) - this module provides 
the data management capability of the system, inter¬ 
preting and executing the various DML commands 
from the user application program. 


Hardware Requirements 

Requirements are the same as the minimum hardware 
requirements for NOS 1. 

INSTALLATION PROCEDURES 

REL54B contains TOTAL Universal Extended 1. The fol¬ 
lowing job installs TOTAL under the TRANEX user 
number. 

JOB. (Supply valid JOB card.) 

USER. (Supply valid USER card.) 

REQUEST, OLDPL # D=800,F=I,LB=KL,VSN=REL54B. 
UPDATE, F, *=/,D, 8. 

SUBMIT, COMPILE. 

7/8/9 

/DE FINE, NT. (Optional.) 

/DE FINE, LIB. (Optional.) 

G/7/8/9 

DEFINE OPTIONS 

NT (Track tape [ 7 track assumed] .) 

LIB (Generates a move deck to install 

files under user number LIBRARY.) 

NOTE 

If the option to place files under user number 
LIBRARY is chosen, a procedure file 
(MOVLIB) is provided under the installation 
account (TRANEX user number) to allow 
the user to put all the files except TOTALE 
under user number LIBRARY, and also 
leave them under the TRANEX user number. 

To do this, the installation job above is run. 

Then the user must enter the following from 
the console: 

X.DIS 

USER,KB100DC. (TRANEX user number.) 
CALL, MOVLIB, C. 

TOTALE must always reside under the 
TRANEX user number. If the user elects 
to install under another account number, 
the file TOTALE must be transferred to 
the TRANEX user number. 

To list the installation deck, do the following: 

JOB. (Supply valid JOB card.) 

USER. (Supply valid USER card.) 

REQUEST, OLDPL, D=800, F=I, LB=KL, VSN=REL54B. 
UPDATE, F, L=F,C'-0, *=/. 

G/7/8/9 
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TOTAL UNIVERSAL 2 


RELEASE DESCRIPTION 

TOTAL Universal 2 consists of the following relocatable 
binaries: 

DBGEN (Data base generation program) - this program 
reads user-prepared DBDL statements and generates 
COMPASS source statements which in turn produce the 
data base descriptor module. 

DBFMT (Data set format program) - this program reads 
format parameter statements, and, utilizing a data base 
descriptor module, preformats the data sets. 

DATBAS (Data base interface module) - this module 
serves as an interface between the user application pro¬ 
gram and the TOTAL and data base descriptor modules. 

TOTAL (Data base management module) - this module 
provides the data management capability of the system, 
interpreting and executing the various DML commands 
from the user application program. 

DBRCV (Data base recovery module) - this module, 
optional in use, provides the ability to recover record 
images from the TOTAL logging file. 

TOTUTIL (TOTAL utilities) - this program provides 
TOTAL users with a generalized utility package capable 
of performing file loading/unloading, statistics, and 
other data base functions. 

These files are to be installed on the user’s permanent 
file library (refer to the following section on "Installation 
Procedures"). 

Hardware Requirements 

TOTAL Universal 2 can be maintained and run on the same 
minimum hardware requirements as NOS 1. 


File 1 - installation and verification deck in UPDATE 
format, 

File 2 - empty, 

File 3 - five TOTAL relocatable binaries: DBGEN, 
DBFMT, DATBAS, TOTAL, DBRCV, 

File 4 - source code for TOTAL utilities in UPDATE 
format, 

File 5 - empty, 

File 6 - COBOL compilation output from the valida¬ 
tion job, and 

File 7 - execution output from the validation job. 


INSTALLATION PROCEDURES 

Installation consists of the following steps: 

1. Determine UPDATE directives to modify the 
install deck (as described in the next section). 

2. Create the following job to call the install/ 
validate job from the install tape and submit it 
as a batch job: 

JOB/USER/CHARGE CARDS. (Supply 
valid JOB/USER/CHARGE cards.) 

LABEL, TOT, R, L-TOTALU2P0, D = |HY j 
VSN-REL54C. I HD > , 

W 

UPDATE,Q,* $$SS, P-TOT, L F. 

SUBMIT(COMPILE, B) 

7/8/9 

UPDATE directives 

G/7/8/9 

3. Validate the install/validate job output against 
the sample output copied from the install tape. 


Deficiencies 

None. 


RELEASE MATERIALS 

TOTAL UNIVERSAL 2 release materials are contained 
on program library tape REL54C. REL54C has the 
following characteristics: labeled, 7-track (800 bpi) or 
9-track (800 or 1600 cpi), binary recording mode, 
TOTALU2PO as file ID in HDR1 label. REL54C 
contains seven files: 


INSTALLATION PARAMETERS 

Following are the UPDATE directives to be used as 
described in the previous section. All options are shown 
and explained. 

$ IDE NT INST 

SDEFINE CBL4 ^ (Compiles utilities with COBOL 4 - 
Default is COBOL 5) 

SDEFINE HY| (7-track 800 bpi) j Select one to 

SDEFINE HD > (9-track 800 cpi) > correspond to 

SDEFINE PE j (9-track 1600 cpi)j the installation 

tape density. 

SDELETE INSTALL. 2, INSTALL. 4 
JOB/USER/CHARGE CARDS. (Supply valid JOB/ 

USER/CHARGE cards) 

^COMPILE INSTALL 


I’The ability to compile the utilities using COBOL 4 is provided as a user convenience at this time, but may not be 
supported in future releases. 
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INSTALLATION JOB 

The installation/validation job performs the following: 

1. Issues LABEL card to have install tape 
assigned to job. 

2. DEFENE T s permanent file space for the 
five TOTAL files, and copies them from 
tape to the permanent files. 

3. Compiles TOTAL utilities and creates the 
relocatable binary on the permanent file 
TOTUTIL. 

4. Validation is begun by defining a data base 
using DBGEN. 

5. The test data base is formatted with DBFMT. 

6. Sample data is placed in the data base with a 
COBOL program, and retrievals are performed. 
DATBAS and TOTAL are verified in this phase. 

7. DBRCV is run against the data base for its 
validation. 

8. The TOTAL utilities are validated by executing 
the utilities statistics option. 

9. Finally, the sample output of the install/ 
validation job is copied from the install tape to 
output for verification. 


FILES CREATED 


The installation/validation job purges and defines the 
following files: 


DBGEN 

DBFMT 

DATBAS 

TOTAL 

DBRCV 


Five TOTAL binaries 


TOTUTIL - 
CUSTDB - 
CUCUST ) 
CUINVF j 


TOTAL utility binary 
Validation DBMOD 

Validation data base files 


The user should insure that these files will not conflict 
with already existing files prior to installation. 


TOTAL UNIVERSAL EXTENDED 2 

RELEASE DESCRIPTION 

TOTAL Universal Extended 2 consists of the following 
relocatable binaries: 


DBGEN (Data base generation program) - this pro¬ 
gram reads user-prepared DBDL statements and 
generates COMPASS source statements which in turn 
produce the data base descriptor module. 

DBFMT (Data set format program) - this program 
reads format parameter statements, and utilizing a 
data base descriptor module, preformats the data 
sets. 

DATBAS (Data base interface module) - this module 
serves as an interface between the user application 
program and the TOTAL and data base descriptor 
modules. 

TOTAL (Data base management module) - this 
module provides the data management capability of 
the system, interpreting and executing the various 
DML commands from the user application program. 

DBRCV (Data base recovery module) - this module, 
optional in use, provides the ability to recover 
record images from the TOTAL logging file. 

DATBASE (Data base interface module for trans¬ 
action processing) - this module serves as an inter¬ 
face between the user application program and the 
TOTAL Universal Extended 2 and data base descrip¬ 
tor modules through TRANEX. 

TOTALE (Data base management module for trans¬ 
action processing) - this module provides the data 
management capability of the system, interpreting 
and executing the various DML commands from the 
user application program. 

TOTUTIL (TOTAL utilities) - this program provides 
TOTAL users a generalized utility package capable 
of performing file loading/unloading, statistics and 
other data base functions. 


Hardware Requirements 

Requirements are the same as the minimum hardware 
requirements for NOS 1. 


Deficiencies 

None. 


RELEASE MATERIALS 

TOTAL Universal Extended 2 release materials are 
contained on program library tape REL54D. REL54D 
has the following characteristics: labeled, 7-track 
(800 bpi) or 9-track (800 or 1600 cpi), binary recording 
mode, TOTALE2PO as file ID in HDR1 label. REL54D 
contains seven files: 
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File 1 - installation and verification deck in UPDATE 
format, 

File 2 - empty, 

File 3 - seven TOTAL relocatable binaries: 

DBGEN, DBFMT, DATBAS, TOTAL, DBRCV, 
DATBASE, TOTALE, 


JOB/USER/CHARGE CARDS. (Supply valid JOB/ 

USER/CHARGE cards) 
$DEFINE LIB (If selected, the MOVLIB procedure 
file is installed and can be used later to install 
TOTAL files under user number LIBRARY.) 
SCOMPILE INSTALL 


INSTALLATION JOB 

File 4 - source code for TOTAL utilities in UPDATE 

format, The installation/validation job performs the following: 


File 5 - empty, 

File 6 - COBOL compilation output from the valida¬ 
tion job, and 

File 7 - execution output from the validation job. 

INSTALLATION PROCEDURES 

Installation consists of the following steps: 

1. Determine UPDATE directives to modify the 
install deck (as described in the next section). 

2. Create the following job to call the install/ 
validate job from the install tape and submit it 
as a batch job: 

JOB/USER/CHARGE. (Supply valid JOB/USER/ 
CHARGE cards.) 

LABEL, TOT, R, L^ TOTALE 2 PO, D 

VSNVREL54D. I HD l , 

M 

UPDATE,Q, * = SSSS, P-TOT, L=F. 

SUBMIT (COMPILE, B) 

7/8/9 

UPDATE directives 
G/7/8/9 


1. Issues LABEL card to have install tape assigned 
to job. 

2. DEFINE’s permanent file space for the seven 
TOTAL files, and copies them from tape to the 
permanent files. 

3. Compiles TOTAL utilities and creates the 
relocatable binary on the permanent file 
TOTUTIL. 

4. Validation is begun by defining a data base using 
DBGEN. 

5. The test data base is formatted with DBFMT. 

6. Sample data is placed in the data base with a 
COBOL program, and retrievals are performed. 
DATBAS and TOTAL are verified in this phase. 

7. DBRCV is next run against the data base for its 
validation. 

8. The TOTAL utilities are validated by executing 
the statistics option. 

9. Finally, the sample output of the install/valida¬ 
tion job is copied from the install tape to output 
for verification. 


3. Validate the install/validate job output against 

the sample output copied from the install tape. FILES CREATED 


The installation/validation job purges and defines the 

INSTALLATION PARAMETERS following file: 


Following are the UPDATE directives to be used as 
described in the previous section. All options are 
shown and explained. 

SIDENT INST 

SDEFINE CBL4^ (Compiles utilities with COBOL 4 - 
Default is COBOL 5) 

1 SDEFINE HY| (7-track 800 bpi) \Select one to 
SDEFINE HdI (9-track 800 cpi) 1 correspond to 
SDEFINE PE] (9-track 1600 cpi)J the installation 

tape density 

$DELETE INSTALL. 2, INSTALL. 4 


DBGEN 

DBFMT 

DATBAS 

TOTAL 

DBRCV 

DATBASE 

TOTALE 


- Seven TOTAL binaries. 


TOTUTIL - TOTAL utility binary 
MOVLIB - If SDEFINE LIB was selected during 
installation (MOVLIB is an indirect 
file) 


+ The ability to compile the utilities using COBOL 4 is provided as a user convenience at this time, but may not be 
supported in a future release. 


76071100 N 


1-11-5 



CUSTDB 

CUCUST 

CUINVF 


- Validation DBMOD 

- Validation data base files 


The user should insure that these files will not conflict 
with already existing files prior to installation. 
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RELEASE DESCRIPTION 

TOTAL/ATHENA consists of four relocatable binaries: 

ATB1 | Modules that interface with the TOTAL 
ATB2 I data k ase management system. 

ATRP = the Report Writer module. 

ATPLT r_ the Plotter module. 


HARDWARE REQUIREMENTS 

TOTAL/ATHENA can be maintained and run on the same 
minimum hardware requirements as NOS 1. 


SOFTWARE REQUIREMENTS 

TOTAL Universal 2 must be installed before TOTAL/ 
ATHENA installation is attempted. 


INSTALLATION PROCEDURES 


REL58 contains six files: 

File 1 - install deck in UPDATE format, 

File 2 - empty, 

File 3 - four relocatable binaries: 

-ATB1 ) TOTAL/ATHENA query update 

-ATB2 I binaries, 

-ATRP TOTAL/ATHENA Report Writer, and 

-ATPLT TOTAL/ATHENA Plotter; 

File 4 - TOTAL/ATHENA, Report Writer, and Plotter 
source code deck in UPDATE format, 

File 5 - demonstration decks in UPDATE format: 

-TOTAL/ATHENA, 

-REPORT WRITER, 

-PLOTTER, and 
-TEXT INFORMATION; 

File 6 - sample output from demonstration jobs. 
Installation consists of the following steps: 


a. Select a DEFINE, MT or DEFINE, NT or DEFINE, 
NTPE for install tape processing. 

b. Select a DEFINE,BINARY or DEFINE, SOURCE. 
For execution of TOTAL/ATHENA, Report Writer 
and Plotter compiled binaries, select the DEFINE, 
BINARY. For users to compile their own copies 
of TOTAL/ATHENA, Report Writer and Plotter, 
select the DEFINE!, SOURCE control directive. 

c. Select DEFINE, DEBUG if COBOL DEBUG mode 
is desired. 

2. Create and submit for batch processing the following 
job to call the install deck from the install tape: 

JOB. (Supply valid JOB card.) 

USER. (Supply valid USER card.) 

CHARGE. 

LABEL, TA1, R, L=TOTALATHENA, 

j HY | 

D= j HD , VSN=REL58. 

UPDATE(Q, P=TA 1, L=F, W, D, 8, R, *=/) 

SUBMIT (COMPILE, B) 

7/8/9 
/ID INST 

[MT [(7-track, 800 bpi.) \ Select MT, 
/DEFINEINT I (9-track, 800 cpi.) i NT, or 
vNTPeI( 9-track, 1600 cpi.)j NTPE 
/DEFINEJSOURCE Select BINARY or SOURCE 
{BINARY (see instructions.) 

1/define, (debug] 

/D INSTALL. 2, INSTALL. 4 
JOB. 

USER. (Supply valid USER card.) 

CHARGE. (Supply valid CHARGE card.) 

/D INSTALL. 99, INSTALL. 101 
JOB. 

USER. (Supply valid USER card.) 

CHARGE. (Supply valid CHARGE card.) 

/COMPILE, INSTALL 

G/7/8/9 

3. Verify that the output from the demonstration job 
matches the listing of the install tape sample output 
file. Verify that the output obtained from interactively 
executing the ATHENA plotter matches the output 
listed in the demonstration job text file. 


1. Choose the UPDATE directives that are required in 
step 2 to modify the install deck. 


r 


u 
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INSTALLATION JOB 


The installation jobs perform the following: 

1. Issue LABEL to have REL58 assigned to job. 

2. For installation of the T/A binary files (/DEFINE, 
BINARY), the install job defines the two TOTAL/ 
ATHENA Report Writer and Plotter files and copies 

c them from REL58 to the permanent files (no passwords 
are assigned). 

3. For the user to compile binaries from TOTAL/ 
ATHENA source code (/DEFINE,SOURCE) the install 
job defines the two TOTAL/ATHENA files, the 
TOTAL/ATHENA Report Writer, and Plotter files, 
copies and updates the TOTAL/ATHENA source code 
from tape to disk, and compiles the source code 
generating the TOTAL/ATHENA, Report Writer and 
Plotter binaries. 

4. A TOTAL/ATHENA demonstration is begun by defining 
a data base using DBGEN (TOTAL module). 

5. A test data base is formatted with DBFMT (TOTAL 
module). 

6. Sample data is placed in the data base with TOTAL/ 
ATHENA and then TOTAL/ATHENA retrievals and 
functions are performed. 

7. A TOTAL/ATHENA Report Writer demonstration is 
then processed with SUBSET and COMMAND file data 
supplied on the install tape. 

8. A TOTAL/ATHENA plotter demonstration should then 
be processed by the installer. The plotter data base 
and a text file of instructions to the installer is 
supplied on the install tape. 

9. The output of the demonstration is then compared 
against the validation output copied from the install 
tape earlier. 

This job lists the install deck as it appears on file 1 of 

REL58: 

JOB. (Supply valid JOB card.) 

USER. (Supply valid USER card.) 

CHARGE. 

LABEL, TA1, R, L=TOTALATHENA, 

|HY | 

D= j HD | , YSN-REL58. 

I PE ) 

UPDATE(Q, P=TA1, L=F, *=/) 

7/8/9 


/ID ATHLIST 
/COMPILE INSTALL 
6/7/8/9 


DEMONSTRATION JOB 

The demonstration deck in UPDATE format includes the 
demonstration job and the necessary input records to the 
demonstration job. The demonstration job performs these 
operations: 

1. Generates a TOTAL DBMOD and formats a TOTAL 
data base. 

2. Creates and executes the TOTAL/ATHENA query/ 
update executable binary. 

3. Executes the TOTAL/ATHENA report generator 
module. 

4. Defines and copies a TOTAL/ATHENA plotter 
SUBSET file. 

5. Prints a text file that describes how to verify the 
TOTAL/ATHENA plotter. 

This job lists the demonstration deck as it appears on 
file 5 of the install tape: 

JOB. (Supply valid JOB card.) 

USER. (Supply valid USER card.) 

CHARGE. 

LABEL, TA1,R, L=TOTA LATH ENA, 

( HY 1 

D= J HD \ ,YSN=REL58. 

y pe t 

SKIPF, TA1,4. 

UPDATE(Q, L-F,P=TA 1, *=SSSS,R) 

7/8/9 

SID ATHLIST 
SCOMPILE TADEMO 

6/7/8/9 

NOTE 

The binary files on this release were 
generated on a non-CMU CYBER 
system. 
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UNIPLOT 3 OVERVIEW 


RELEASE DESCRIPTION 

UNIPLOT 3 (Universal Plotting Software Version 3) con¬ 
sists of two components: a library of FORTRAN Extended 
routines which are CalComp call-compatible (UNIPLOT) 
and a post processor (UNIPOST). The UNIPLOT routines 
write a neutral picture file, NPFILE, which can then be 
read by the post processor to produce graphic output on 
a variety of plotting devices. UNIPLOT 3 is designed to 
be used by all application programs which make CalComp 
calls to produce graphic displays. 

The operation of UNIPLOT 3 requires the installation of 
the batch and/or interactive facility (depending on the 
post processor used) and all other associated products 
under NOS 1. 


HARDWARE CONFIGURATION 

The minimum hardware configuration required by NOS 
is required to support UNIPLOT 3. 


HARDWARE OPTIONS 

A graphic terminal or plotting device is required if 
displaying of graphic data is to be done on site. The 
terminals currently supported by UNIPLOT 3 are: 

1. Tektronix 401X series graphic terminals, 

2. Houston Instrument BTC-7 controllers and 
compatible plotters, 

3. CalComp 906 controllers and compatible plotters. 


NOTES AND CAUTIONS 

All limitations applicable to NOS also apply to UNIPLOT 3. 

All UNIPLOT 3 neutral picture routines are callable from 
a user ? s application program written in FORTRAN Extended 
only. 

All three supported devices operate asynchronously only. 


UNIPLOT 3 


RELEASE MATERIALS 

UNIPLOT 3 resides on the tape known as REL66. 

REL66 has the following characteristics: 7-track (800 
bits per inch [bpi]) or 9-track (800 or 1600 characters 
per inch [cpi]), binary recording mode, UNIPLOTV3 as 
file ID in the HDRl label, and six files: 

File 1 - Installation job program library in UPDATE 
PL form, 

File 2 - Absolute binaries for UNIPOST main overlay 
and one secondary overlay (DUMP) which 
does a dump of the NPFILE, 

File 3 - Relocatable binaries for the UNIPLOT neutral 
picture routines, 

File 4 - UNIPLOT 3 program library in UPDATE PL 
form consisting of two records; the first is 
UNIPOST and the second is UNIPLOT, 

File 5 - Verification job program library in UPDATE 
PL form, and 

File 6 - Empty. 

INSTALLATION PROCEDURE 

To obtain a listing of the installation job and the verification 
job execute the following: 

LIST. 

USER. (Supply valid USER card.) 

LABEL(OLDPL, L=UNIPLOT V3, PO=R, R, 

| HY | 

D=< HD \ , VSN=REL66) 

l PE) 

UPDATE(F, *==, L=7) 

SKIPF(OLDPL, 4) 

UPDATE(F, *==, L=7, R) 

6/7/8/9 

The installation of UNIPLOT 3 saves the library of 
UNIPLOT neutral picture routines, the relocatable binaries 
for the UNIPOST post processor, the absolute binaries for 
UNIPOST and the UNIPLOT program library. The instal¬ 
lation job resides in UPDATE program library format as 
file 1 of the UNIPLOT 3 release tape, REL66, with a 
master character of equals (=). As part of the following 
job, a dummy USER statement on the installation program 
library must be deleted and the appropriate USER statement 
inserted. 
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CAUTION 


NOTE 


The following direct access permanent files are 
saved when this job is run. If files already exist 
under these names, they must either be purged 
or renamed: 

1. UNIPLOT/CT=PU, PW=UNIPLOT - relocat¬ 

able binaries for UNIPLOT neutral 
picture routines 

2. UNIPOST/CT=PU, PW=UNIPLOT - absolute 

binaries for UNIPOST post processor 

3. POSTLGO/CT^PU, PW=UNIPLOT - relocat¬ 

able binaries for UNIPOST post 
processor 

4. UNV30PL/CT=PU, PW=UNIPLOT - UPDATE 

program library 

NOTE 

A backup tape is not created by this job. UNIPOST 
and the UNIPLOT program library on REL66 are 
not replaced with versions containing the post 
processor code. However, the direct access files 
created by the installation job do contain the 
integrated post processor routines. 

If the Tektronix 401X post processor option is installed, 
the following permanent file is also created as direct 
access: 

PLOTIO/CT=PU, PW=PLOT10 - relocatable binaries 
for Tektronix driver routines. 


REL66 is the only tape needed for the EXTRACT 
job. However, the job submitted to the NOS 
input queue requires REL66 and all post processor 
tapes being installed (REL66A, REL66B and/or 
REL66C). See the individual postprocessor 
sections for descriptions of these tapes. 


INSTALLING A NEW DEVICE 


CREATING A NEW POST PROCESSOR DEVICE OVERLAY 

The post processor reads vector and character strings 
from the UNIPLOT neutral picture file, modifies that 
information according to user directives, and calls sub¬ 
routines to produce vector and character commands 
acceptable to the selected device. The subroutines that 
produce acceptable commands are different for each 
plotting device, so if many devices are supported, the 
post processor core requirements could grow very large. 

To avoid this large core requirement, the subroutines 
specific to a given device are placed in one overlay, which 
is called into core when the device is selected and kept 
there until the post processor execution is terminated. 

A labeled common block, /PPREQ/, is used by the post 
processor main overlay to communicate with the device 
routines in the primary overlay. Each time control is 
returned to the primary overlay, /PPREQ/ contains 
information which directs the overlay's main program to 
call a specific device routine with parameter values also 
contained in /PPREQ/. 


To install UNIPLOT 3 with the desired post processor(s) 
run the following job: 

EXTRACT. 

USER. (Supply valid USER statement) 

LABEL(OLDPL, L=UNIPLOTV3, PO=R, R, 

l HY l 

D= l HD \ , VSN=REL66) 

(pe) 

UPDATE(Q, *=,D, 8) 

SUBMIT( COMPILE) 

7/8/9 

=IDENT ANY 

=DEFINE HI200 (If installing Houston Instruments 
post processor) 

=DEFINE CAL906 (If installing CalComp post 
processor) 

=DEFINE TEK (If installing Tektronix post 

processor) 

I MT \ (If 7-track tape) 

NT i (If 9-track 800 cpi tape) 

NT 16 j (If 9-track 1600 cpi tape) 
=DELETE. INSTA LL. XX 

USER. (Supply valid USER statement) 

^COMPILE INSTALL 

6/7/8/9 


In order to support a new plotting device, the programmer 
must write a new overlay main program that calls 
initialization, vector plotting, pen select, termination and 
possible character plotting routines specific to the device 
being supported. Then the post processor relocatables 
must be reloaded along with the new overlay. 


SUBROUTINE DEVLIST 

C DEVLIST CONTAINS THE LIST OF DEVICE KEYNAMES AND THE 

C CORRESPONDING OVERLAY NUMBER IN THE DEVICE ARRAY. 

C 

C NDEVICE CONTAINS THE KEYNAME SPECIFIED BY THE DEVICE 

C DIRECTIVE. 

C 

C NOVER CONTAINS THE OVERLAY NUMBER 0? THE SPECIFIED 

C DEVICE ARRIVED AT BY MASKING OUT THE OISPLAY CODE OF 

C THE NUMBER AND CONVERTING IT TO AN INTEGER. 

C ' ? 

C TO ADD A NEW DEVICE KEYNAME FOLLOW THESE STEPS 

C 

C 1. INCREASE THE DEVICES DIMENSION STATEMENT AND THE 

C DO LOOP INDEX BY THE NUMBER OF DEVICES TO BE ADDED. 

C 

C 2. ADD THE KEYNAME AND OVERLAY NUMBER IN DECIMAL 

C JO DEVICES IN 10HXXXXXXXNNN FORMAT. REMEMBER 

C THAT THE OVERLAY CARD ITSELF MUST BE IN OCTAL. 

C .v 

COMMON /DEVICE/. NDEVICE.NOVER 
INTEGER DEVICE(4) 

DATA (DEVICE(I).1=1,4) 

1 : /10HDUMP 001. 

2 10HTEK 009, 

3 10HHI200 004, 

4 10HCAL906 043/ 

C 

MAXDEV-4 

NOVER=0 

DO 100 ind=i,maxdev 

IF(AND(MASK(42).DEVICE(IND)).EQ. 

1 AND(MASK(42),NDEVICE)) GO TO 200 

100 CONTINUE 
RETURN 
C 

C CONVERT OVERLAY NUMBER 

C 

200 NUM=SHIFT(DEVICE<IND),4B) 

DO 250 1 = 1,3 

iDIGIT=AND(NUM»77B>-33B A 

NOVER=10*NOVER*IDIGIT /f 

250 NUM=SHIFT(NUM.6) yj 

RETURN 1 

END 


• 1-13-2 


76071100 R 



WRITING A NEW DEVICE 
OVERLAY MAIN PROGRAM 


The design requirements for an overlay main program are 
as follows: 

1. That it call device-dependent routines in order to 
plot the graphic data specified in common block 
/PPREQ/. (Details are given on the following 
pages.) 

2. That upon being entered with an initialization 
request, it enters into /PPREQ/ a list of 
properties and parameters of the device that 
the overlay supports before the first call to 
NPFDATA. 

3. That the overlay makes calls to a main overlay 
subroutine NPFDATA to obtain data from the 
neutral picture file. The NPFDATA subroutine 
will set the /PPREQ/ common block and return 
to the overlaj 7 . Thus, the overlay will loop, 
calling NPFDATA until processing is complete. 

The name of the overlay must be UNIPOST and the number 
must be in octal and correspond to the decimal number of 
the name of the device in table DEVICE in subroutine 
DEVLIST. 

If the device dependent routines use FORTRAN I/O, 

TAPE4 should be used as the file to which the plot com¬ 
mands will be written. If the device routines open their 
own file and use CIO, the filename used for the plot 
output is specified in IPRM(2) when the overlay is called 
with IREQ=0. 


INTERFACE WITH THE DEVICE ROUTINES 


The manufacturer-supplied device dependent subroutines 
for each different plotting device are loaded in different 
overlays. Each overlay has a custom-written main 
program that calls a working routine in the main (0,0) 
overlay to pick up request codes and parameters from 
the neutral picture file. Upon return to the primary 
overlay, these codes and respective parameters are in 
the PPREQ common block. The codes direct the primary 
overlay T s main program to call a specific device depend¬ 
ent routine with the parameters supplied. 

The PPREQ common block is defined as follows: 

COMMON/PPREQ/IREQ, IPRM(31) 

DIMENSION FPRM(31) 

EQUIVALENCE (IPRM, FPRM) 

IREQ is an integer whose value specifies the kind 
of request being made. IPRM is an array that contains 
integer parameters to be used in carrying out the request. 
FPRM is an array that contains floating point parameters 
to be used in carrying out the request. The requests are 
as follows: 


INITIALIZATION REQUEST (IREQ=0) 


The device overlay returns to the main program certain 
information about the display or plotting device. It is 
usually a requirement of the device dependent subroutines 
that they be initialized only once in a run unless PLOT 
(X,Y,999) has been called. 

Upon entry into the overlay with IREQ=0, the IPRM array 
is set as follows: 


IPRM(l) = 

device keyname 

IPRM(2) - 

name of the device dependent plot file 
to be used only with CIO; default is 
PLOTF 

The primary overlay main program must then set the 
values in PPREQ as follows: 

IPRM(l) m 

device type: 1 = drum plotter 

2 «table plotter 

3 - storage tube display 

4 = microfilm device 

FPRM (2) = 

display surface extent in X direction 
in inches or centimeters 

FPRM(3) - 

display surface extent in Y direction 
in inches or centimeters 

IPRM(4) = 

number of pens 

IPRM (5) - 

is there hardware character generation 
0 = no 1 ~ ves 

IPRM(6) = 

are there hardware generated dotted 
lines ? 

0 = no 1 = yes 

IPRM(7) - 

are there hardware generated dashed 
lines ? 

0 - no 1 = yes 

IPRM(8) = 

is there hardware arc generation? 

0 = no 1 = yes 

IPRM(9) = 

is there hardware cubic generation? 

0 ~ no 1 - yes 

IPRM(10) - 

number of increments per inch 
(i.e., 100,200,400,...) 

IPRM(ll) -- 

normal mode of operation 

0 = batch processing 

1 = interactive processing 

IPRM (12) = 

post processor device unit of measure 

0 = inch 

1 = centimeter 


The device overlay then calls the working routine, 
NPFDATA, in the main overlay which transfers the above 
information into the appropriate variables and transfers 
control to the main processor. 
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The main processing unit of the main overlay reads another 
buffer from NPFILE and fills the PPREQ common area and 
returns to the working routine which returns to the device 
overlay. 

Upon return to the device overlay, PPREQ contains one of 
the following requests: 


VECTOR REQUEST (IREQ=1) 

The vector request provides the arguments necessary for 
a call to the CalComp standard subroutine PLOT or its 
equivalent. A value of 999 in IPRM(3) indicates that the 
current request is the final request in the run, and buffers 
should be purged, files closed, as required, and the 
program ended. A dashed or dotted vector (IPRM(3) = 

4 or 5) is requested only if the presence of those features 
was indicated in the return from the initialization request. 


FPRM(l) = X-coordinate 
FPRM(2) = Y-coordinate 


IPRM(3) 


vector type: 

2 for solid line 

3 for invisible 

4 for dash line 

5 for dotted line 
-3 for new picture 

999 for end of run 


Only if hardware 
dashed/dotted 
lines are avail¬ 
able. 


NEWPEN REQUEST (IREQ=2) 

A call to the CalComp standard subroutine NEWPEN or the 
equivalent is requested. 

IPRM(l) = pen number 

IPRM(2) = maximum number of pens 

The request may be made for a single pen plotter if the 
application creating the neutral picture file calls NEWPEN 
with a negative pen number. If IPRM(l) is negative on a 
single pen plotter, the following calls should be made if 
applicable: 

CALL PLOT(0. 0, 0. 0, 999) 

CALL PLOTS(IBUF, ISIZE, IUNIT) 

ALPHA STRING REQUEST (IREQ=3) 

This request provides the overlay with the parameters 
needed for a character string call to the CalComp standard 
subroutine SYMBOL (only if hardware character generation 
is available on the device). Up to 100 characters may be 
present in each request. The X and Y coordinates usually 
have values of 999.0, indicating that the string is to be 
started at the current pen position. Centered symbols are 
not included in this type of request. 


FPRM(l) = X-coordinate of start of character string 
FPRM(2) = Y-coordinate of start of character string 
FPRM(3) = character height 

FPRM(4) = angle of baseline of character string 
in degrees 

IPRM(5) = number of characters 
IPRM(6)-IPRM(15) = BCD character string 


DEVICE MODE REQUEST (IREQ=4) 

Arguments to device independent subroutines are passed 
unchanged through the neutral plot file. If the user of the 
post processor selects the proper display device, a 
plotter mode request will be made to the overlay. The 
overlay should inspect IPRM(l) which will contain the 
name of the device specific routine in left-justified A10 
format, and then call the specified routine using the 
subsequent words of IPRM as the arguments (use FPRM 
if an argument is of type REAL). The words of the array 
are used in ascending order from left to right in the 
subroutine argument list. (See Appendix E, UNIPLOT 
V2.1 Reference/User Guide, Publication No. 60454730, 
Revision C, for a description of Device Mode Subroutine) 

IPRM(l) = name of subroutine; A10 format, left- 
justified 

IPRM(2)-IPRM(13) = subroutine arguments 
FPRM(2)-FPRM(13) = subroutine arguments 

REORIGIN REQUEST (IREQ=5) 

This request is part of the overplot feature and is intended 
to be used by CRT-type displays only. Whenever a new 
drawing (reorigin) occurs in the neutral picture file, the 
overlay for a CRT display must decide whether or not to 
erase the current contents of the display. This decision 
is made by testing the overplot flag. 

IPRM(l) = overplot flag 

0 = do not overplot; erase 
1 = overplot; do not erase 

INCREMENT REQUEST (IREQ=6) 

This request passes the value of the plotter increment size, 
as input by an INCREMENT post processor directive to 
the overlay. The overlay may, on the basis of this value, 
call FACTOR to adjust the size of the finished plot. If no 
INCREMENT directive has been processed, the value of 
the plotter increment will be the default increment as set 
by the device dependent routines. If IREQ=6, the variable 
containing the increments per inch should be modified 
accordingly for any future initialization. 

FPRM(l) = plotter increment size 

(i.e., .01, .005, or.0025) 
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PEN RESTORE (IREQ=7) 

This request instructs the device overlay to call the device 
dependent PLOT routine to move the pen to the bottom of 
the plotter as follows: 

CALL PLOT(0.0,-30.0,-3) 

There are two ways a user can add a new device overlay 
to UNIPOST. The first adds the overlay to UNIPOST 
source code and the second merges relocatable binaries 
for UNIPOST and the new device overlay. Both methods 
require that an installation job be run first, even if no 
post processors are to be installed. 

NOTE 


LOAD(OVL) 

SATISFY (LIB1) 

NOGO. 

7/8/9 

*IDENT device 
*DELETE DEVLIST.XX 

I (Insert changes to DEVLIST.) 

* COMPILE DEVLIST 
7/8/9 

I (Insert interface program.) 

6/7/8/9 


CALCOMP 906 POST PROCESSOR OPTION 


Neither job writes a back-up tape of REL66 

with the new device code merged into the binaries RELEASE DESCRIPTION 

or program library. 

The CalComp 906 post processor option runs under the 
The first method requires running the following job: NOS operating system when installed with UNIPLOT 3. 


ADDEV1. 

USER. (Supply valid USER statement.) 

LABEL(OLDPL, L-UNIPLOTV3, PO=R, R, 

I HY | 

HD > , VSN=REL66) 

PE J 

UPDATE(Q, *==, D, 8) 

SUBMIT( COMPILE) 

7/8/9 

=IDENT ANY 

^DEFINE TEK (Must be included if Tektronix post¬ 
processor is installed) 

^DELETE ADD.XX 

USER. (Supply valid USER statement.) 

^DELETE ADD.XX 
*IDENT device 
*DELETE DEVLIST. XX 

! (Insert changes to DEVLIST.) 

*ADDFILE 

*DECK device „ . . . 

. (Insert interface program and device 

! dependent routines here.) 

6/7/8/9 

The second method requires running the following job: 
ADDEV2. 

USER. (Supply valid USER statement.) 

ATT A CH (OLDPL=UNV3 0PL) 

UPDATE (Q) 

ATTACH, UNI3=POSTLGO. (Saved during the install 

procedure.) 

ATTACH, LIBl=PLOTLIB. (Attach your device depend¬ 
ent routines.) 

FTN, I. 

FTN, B=OVL. 

REWIND(LGO, OVL) 

COPYL, UNI3, LGO, UNI3A. 

ATTACH (UNIPOST/M=W) 

FILE (PLOT F, RT=S, BT=C) 

LDSET(FILES=PLOTF) 

LOAD(UNI3A) 


HARDWARE CONFIGURATION 

UNIPLOT 3 with the CalComp 906 post processor option 
requires the same minimum hardware configuration as 
NOS. A CalComp 906 controller and a compatible plotter 
must be available for displaying graphic data. 

RELEASE MATERIALS 

The CalComp 906 post processor option resides on the 
tape known as REL66A. REL66A has the following 
characteristics: 7-track (800 bpi) or 9-track (800 or 
1600 cpi), binary recording mode, CAL906 as file ID in 
the HDRl label, six files: 

File 1 - empty, 

File 2 - empty, 

File 3 - empty, 

File 4 - CAL906 source for the device dependent 
routines. 

File 5 - empty, and 
File 6 - empty. 

INSTALLATION PROCEDURE 

The CalComp 906 post processor option must be installed 
with UNIPLOT 3. The installation procedure is contained 
on File 1 of the UNIPLOT 3 tape, REL66. The name 
CAL906 is defined in the installation job to add the CalComp 
906 post processor code into the UNIPLOT system. 

(Reference "Installation Procedure" for UNIPLOT 3.) 
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INSTALLATION VERIFICATION 


RELEASE MATERIALS 


To verify the installation of UNI PLOT 3 with the Cal 
Comp 906 post processor option, the following job should 
be run: 

VERIFY. 

USER. [HY| 

LABEL(OLDPL,L=UNIPLOTV3,PO=R,R,D= <HdI , 
VSN = REL66) (PEJ 

SKIPF(OLDPL, 4) 

UPDATE(Q,*= =,D, 8, R) 

REWIND (COM PILE) 

SUBMIT(COMPILE) 

7/8/9 

= IDE NT ANY 

= DELETE VERIFY .XX 

USER. (Supply valid USER statement.) 

= C0MPILE VERIFY 
6/7/8/9 

The verification procedure saves a direct access neutral 
picture file (NPFILE) for subsequent post processing. 

To post process the neutral picture file, run the following 
job interactively: 

ATTACH, NPFILE 
ATTACH, UNIP0ST 
ASSIGN, TT, PLOTF 
UNIPOST, D = C AL906,0 = PLOTF 

NOTE 

When running under NAM/IAF, the cancel 
character and page width must be changed 
as follows before executing the above job: 

%CN=[ and %PW = 131. 

Figure 1-13-1 shows the first picture generated when 
plotting begins. 


HOUSTON INSTRUMENT BTC-7 
POST PROCESSOR OPTION 

RELEASE DESCRIPTION 

The Houston Instrument BTC-7 post processor option runs 
under the NOS operating system when installed with 
UNIPLOT 3. 


HARDWARE CONFIGURATION 

UNIPLOT 3 with the Houston Instrument BTC-7 post pro¬ 
cessor option requires the same minimum hardware con¬ 
figuration as NOS. A Houston Instrument BTC-7 controller 
and a compatible plotter must be available for displaying 
graphics data. 


The Houston Instrument BTC-7 post processor option 
resides on the tape known as REL66B. REL66B has the 
following characteristics: 7-track (800 bpi) or 9-track 
(800 or 1600 cpi, binary recording mode, HI200 as file 
ID in the HDR1 label, six files: 

File 1 - empty. 

File 2 - empty. 

File 3 - empty 

File 4 - HI200 source for the device dependent routines. 
File 5 - empty, and 
File 6 - empty. 


INSTALLATION PROCEDURE 

The Houston Instrument BTC-7 post processor option must 
be installed with UNIPLOT 3. The installation procedure 
is contained on file 1 of the UNIPL0T 3 tape, REL66 . The 
name HI200 is defined in the installation job to add the 
Houston Instrument BTC-7 post processor code into the 
UNIPLOT system. 

(Reference "Installation Procedure" for UNIPLOT 3 .) 

INSTALLATION VERIFICATION 

To verify the installation of UNIPLOT 3 with the Houston 
Instrument BTC-7 post processor option, the following 
job should be run: 

VERIFY. 

USER. (Supply valid USER statement.) (IIYj 

LABEL(OLDPL, L=UNIPLOTV3, PO~R, R, D= <HD> , 
VSN = REL66) (PE) 

SKIPF(OLDPL, 4) 

UPDATE(Q, * = = D,8,R) 

REWIND(COMPILE) 

SUBMIT (COMPILE) 

7/8/9 

= IDENT ANY 

= DELETE VERIFY.XX 

USER. (Supply valid USER statement.) 

^COMPILE VERIFY 
6/7/8/9 
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The verification procedure saves a direct access neutral 
picture file (NPFILE) for subsequent post processing. 

To post process the neutral picture file run the following 
job via batch: 

JOB. 

USER . (Supply valid USER statement.) 
ATTACH,NPFILE. 

ATTACH, UNIPOST. 

UNIPOST, D=HI200. 

REWIND, PLOTF. 

COPYBF, PLOTF. 

6/7/8/9 

Figure 1-13-1 shows the first picture generated when 
plotting begins. 

TEKTRONIX 401X 
POST PROCESSOR OPTION 


RELEASE DESCRIPTION 

The Tektronix 401X post processor option runs under 
the NOS operating system when installed with UNIPLOT 3 
using either the Time-sharing Module or NAM/IAF. 


HARDWARE CONFIGURATION 

UNIPLOT 3 with the Tektronix 401X post processor 
option requires the same minimum hardware con¬ 
figuration as NOS. A Tektronix 401X series terminal 
must be available for displaying graphics data. 

RELEASE MATERIALS 

The Tektronix 401X post processor option resides on the 
tape known as REL66C . REL66C has the following 
characteristics: 7-track (800 bpi) or 9-track (800 or 
1600 cpi), binary recording mode, TEKTRN as file ID 
in the HDR1 label, six files: 

File 1 - empty. 

File 2 - empty. 

File 3 - relocatable binaries of the Tektronix device 
dependent code. 

File 4 - TEKTRN source for the device dependent 
routines. 

File 5 - empty, and 
File 6 - empty. 


INSTALLATION PROCEDURE 

The Tektronix 401X post processor option must be in¬ 
stalled with UNIPLOT 3. The installation procedure is 
contained on File 1 of the UNIPLOT 3 tape, REL66. The 
name TEK is defined in the installation job to add the 
Tektronix 401X post processor code into the UNIPLOT 
system. 


(Reference ’’Installation Procedure” for UNIPLOT 3 .) 

INSTALLATION VERIFICATION 

To verify the installation of UNIPLOT 3 with the Tektronix 
40IX post processor option, the following job should be 
run: 

VERIFY. 

USER. (Supply valid USER statement.) | HY | 

LABEL(OLDPL, L=UNIPLOTV3, PO=R, R, D= I HD l 
VSN=REL66) PE 

SKIPF(OLDPL, 4) V ' 

UPDATE(Q, * = =, D, 8, R) 

RE WIND (COMPILE) 

SUBMIT(COMPILE) 

7/8/9 

= IDENT ANY 

= DELETE VERIFY.XX 

USER. (Supply valid USER statement.) 

COMPILE VERIFY 
6/7/8/9 

The verification procedure saves a direct access neutral 
picture file (NPFILE) for subsequent post processing. 

To post process the neutral picture file, run the following 
job interactively: 

ATTACH, NPFILE 
ATTACH, UNIPOST 
UNIPOST, D = TEK 

NOTE 

When running under NAM/IAF, the cancel char¬ 
acter must be changed to [ before executing UNI¬ 
POST. Type in UCN=[ to change the cancel 
character before running the above job. 

Figure 1-13-1 shows the first picture generated when 
plotting begins. 
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USAGE ACCOUNTING UTILITY 


14 


RELEASE DESCRIPTION 


The Usage Accounting Utility release tape (AP001N) for 
NOS 1 consists of the following three files: 

File 1 - the installation deck PL containing the 
UAUINS job which installs the software necessary to 
provide accounting for usage priced software. 

File 2 - RANDR (Update/data reduction/report 
generation program) - this program reads user pre¬ 
pared input directive cards and performs the functions 
specified bv the directives. The functions, all re¬ 
lating to the product file and the usage detail file are: 

1. Maintain product file data base. 

2. Reduce data on the usage detail file and pro¬ 
duce detail usage summary/billing reports 
as per directives. 

3. Generate system status reports. 

File 3 - ACOUNTX - (Usage pricing accounting 
module) - this set of subroutines provides the ac¬ 
counting interface to usage priced applications. 
ACOUNTX tracks application usage and logs that 
usage on the usage detail file. 

RANDR and ACOUNTX are to be installed on the SYSTEM 
library SYS LIB. 

HARDWARE REQUIREMENTS 

RANDR can be maintained on the same minimum hardware 
configuration as NOS 1. The amount of core over and 
above that required by the calling application depends upon 
whether or not the calling application uses the CYBER 
record manager (CRM), the common memory manager 
(CMM), and/or is written in FORTRAN Extended Version 
4 (FTN-4) (see table 1-14-1). 

TABLE 1-14-1. ADDITIONAL CORE REQUIREMENTS 

Maximum Additional Core 

Application Characteristics Required for ACOUNTX 


CRM 

FTN-4 

CMM 

(In Octal) 

YES 

YES 

YES 

2.5K 

YES 

YES 

NO 

3. IK 

YES 

NO 

YES 

3.6K 

YES 

NO 

NO 

4.2K 

NO 

YES 

YES 

12.5K 

NO 

YES 

NO 

13. IK 

NO 

NO 

YES 

13. 6K 

NO 

NO 

NO 

14.2K 


CORRECTIONS 

There are no applicable PSR summaries. 

DEFICIENCIES 

It is imperative that at least one billing run be made in the 
month of January to prevent corruption of the year-to-date 
totals. 


Notes and Cautions 

When loading an application calling ACOUNTX, nonfatal 
load errors may occur due to duplicate system entry points. 
Other errors should be investigated. 


INSTALLATION PARAMETERS 

Upon installation (creation) of the two necessary files, the 
product file and the usage detail file, various protection 
parameters may be specified on the input card (ID=T) 
specifying UPDATE (see Usage Accounting Utility Reference 
Manual) . 

Column Contents 

1 to 4 CPU model code; this is a four-character 

code associated with the machine type and 
will not be changed after the files are 
established. (The codes are found in ap¬ 
pendix C of the Usage Accounting Utility 
Reference Manual. ) The customer, in the 
event of a CPU model upgrade (for example, 
a CYBER 172 with a 10316-1 upgrade is a 
CYBER 173), is obligated to perform a 
final billing run on the existing product 
and detail files, remove those files, and 
recreate them with the appropriate CPU 
model code. 

5 Blank; reserved. 

6 Threshold protection indicator; Y specifies 
that special usage accumulator entries will 
be built, updated, and maintained in the 
usage detail file; accumulators, thresholds 
and product status (active or inactive) are 
checked and/or updated at start and end of 
an application. N specifies no special 
threshold checking is to be done. 

Blank defaults to N. 
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Column 


Contents 


Column 


Contents 


This parameter may be changed at any 
time. However, altering it from Y to N 
and vice versa between billing runs cor¬ 
rupts the effectiveness of threshold 
protection. 

The special usage accumulator entries con¬ 
tain a usage accumulator. During a billing 
run, which covers a period of at least one 
full month, the accumulator is decre¬ 
mented by the invoiced amount of usage. 

The special usage accumulator entries are 
lost when a billing run is made with the 
threshold protection installed as N. They 
can be reestablished (initialized) via an 
UPDATE run with threshold protection 
set to Y. 

NOTE 

Threshold protection is merely to 
assist the site in limiting their 
usage and is not intended in any 
way to limit the sites’ liability 
for usage as reported in monthly 
billing runs. 

7 to 9 Blank, reserved. 

10 to 14 Right-justified number (blanks treated as 
zero). It is multiplied by 1000 and repre¬ 
sents the size (in number of words) at 
which the operator is warned that the de¬ 
tail file size protect has been reached. 

No other action is performed. It is the 
site responsibility to make a billing run 
(see Usage Accounting Utility Reference 
Manual) to reduce and report the usage 
detail file. 

This parameter may be changed at any 
time. 

15 Blank, reserved. 

16 User number field protection; Y specifies 
that the user number will be blanked on 
all detail usage reports. 

N specifies that user numbers for each ac¬ 
counting job step will appear on the detail 
usage reports. 

Blank defaults to N. 

This parameter may be changed at any 
time. 

The following information represents directives to RANDR 
and is not considered installation parameters. 


17 

Blank, reserved. 

18 

1; represents parameter type card. 

19 

1 to 9; represents number of copies of 
report. 

20 to 25 

UPDATE 

26 to 80 

Blank, reserved. 


NOTE 


After installation creation, any of 
the above installation parameters 
may be changed except the CPU 
model code without removing and 
recreating files. 

Also upon installation (creation) of the two necessary files 
(product and usage detail), a Control Data regional address 
must be installed. The Control Data address to be used is 
specified on the front of the software contract. In addition, 
the customer is obligated to supply their address and the 
name of an individual as a primary contact for resolution 
of any matters which may arise pertaining to the prepara¬ 
tion, content and submission of the usage reports. The 


address information is specified on the input cards (ID=2,3) 
to the creation run and may be altered in part or whole by 
update runs. 


For each specific usage priced product, there is additional 
installation information to be specified on the product ac¬ 
tivity card (10=4); vendor code, product name, transaction 
codes, threshold protection values, and software codes. 
The vendor code, product name, and software code for 
Control Data usage priced products are supplied with the 
installation information; see specific application product 
description in this manual. Threshold protection values 
are supplied by the site. 

(For further description of the input card types, see the 
Usage Accounting Utility Reference Manual.) 


INSTALLATION PROCEDURE 


AP001N contains the usage accounting utility. The RANDR 
and ACOUNTX modules are SYSEDIT'ed into the running 
system. 

The following job is used to retrieve the installation job 
UAUINS from AP001N. This deck is not available on 
REL2A. 
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UAUID(CM60000, T100) 

USER (usernumber, password) 

COMMENT. THIS JOB SUBMITS A JOB TO INSTALL 
COMMENT. THE USAGE ACCOUNTING UTILITY 
COMMENT. INTO THE RUNNING SYSTEM 
COMMENT. **XX-MT/7-TRACK OR NT/9-TRACK 
COMMENT. **YY=800/800 bpi OR 1600/1600 cpi 
LABEL(UAUTIL, D=YY ,XX, F=T, VSN-AP001N, 
FI=USAGEACCTNG1P0,R) 

UPDATE (P-UAUTIL, *==) 

SUBMIT (COMPILE) 

7/8/9 - EOR - 
UPDATE DIRECTIVES 

THE UPDATE DIRECTIVES VARY 
DEPENDING UPON THE DENSITY 
AND TRACK TYPE BEING USED. 
-DEFINE MT800-7 TRACK, 800 bpi 
-DEFINE NT800-9 TRACK, 800 cpi 
-DEFINE NT1600-9 TRACK, 1600 cpi 

G/7/8/9 - EOI - 

The usage accounting utility is installed on the running 
system from AP001N by running job UAUINS which is 
executed by the above job UAUID. (Refer to the section 
on "Installation Job” for a listing of UAUINS.) 

INSTALLATION JOB 


Prior to running the UAUINS job, the user number 
ACXLIB must be established in the VALIDUx file. 
RANDR establishes the product file and the usage detail 
file under ACXLIB. If ACXLIB is not established or if 
usage accounting files do not exist under ACXLIB, the 
applications interface ACOUNTX will not run. 

(The method of establishing ACXLIB on VALIDUx file is 
presented in the NOS Installation Handbook, part IV, 
section 1.1.2.) 

UAUINS is the job which installs the usage accounting 
utility binaries on the running system. This job must be 
run under user number - ACXLIB. 


RE WIND (NEW) 

LIBGEN(F=NEW, P-SYSLIB) 

SYSEDIT(L) 

CATALOG (SYSTEM, N, R) 

7/8/9 - EOR - 
*TYPE REL 
*B*, ACOUNTX-* 

7/8/9 - EOR - 
*FILE SYSLIB 
*FILE RANDR 
G/7/8/9 - EOI - 

Once the RANDR and ACOUNTX modules are installed on 
the running system, a new deads tart tape of the running 
system should be created. 

Prior to execution of any usage priced applications, the 
following job UAFINS must be run. This job establishes 
the product file, initializes the usage detail file, and 
creates the product file entries for leased CDC usage 
priced application^). 


UAFINS(CM74000, T100) 

USER (ACXLIB) 

COMMENT. (This job must be run under user 
number ACXLIB.) 

COMMENT. (This job establishes the product file and 
COMMENT. initializes the usage detail file.) 

RANDR. 

7/8/9 - EOR - 

(The data deck contents vary depending 
upon the application^) being installed. 


UPDATE 

DATA 

CARDS 


For this initial run there must be 1 
(ID=1) parameter card 3 (ID-2) CDC 
address cards, 3 (ID~3) customer ad¬ 
dress cards, and at least 1 (ID-4) 


product card. [See Usage Accounting 


Utility Reference Manual. ]) 


G/7/8/9 - EOI - 


PRODUCT AND USAGE DETAIL FILES 


UAUINS, CM60000,T100. 

USER, ACXLIB. 

COMMENT. (This job must be run under user 
number ACXLIB.) 

COMMENT. (This job will SYSEDIT the usage ac- 
COMMENT. counting utility binaries into the 
COMMENT. running system.) 

COMMENT. **XX-MT/7-TRACK or NT/9-TRACK 
COMMENT. **YY=800/800 bpi or 1600/1600 cpi 
LABEL(UAUTIL,D-YY,XX, F-I, VSN-AP001N, 
FI-USAGE ACCTNG1P0, R) 

REWIND(UAUTIL) 

SKIPF(UAUTIL, 1) 

COP YBF(UAUTIL, RANDR, 1) 

COPYBF(UAUTIL, ACOUNTX, 1) 

REWIND(RANDR) 

REWIND(ACOUNTX) 

COMMON(SYSTEM) 

GTR (S YST EM, S)ULIB/ SYSLIB 

LIBEDIT(P=S, B-ACOUNTX, N=NEW, V) 


The product file is maintained as a direct access permanent 
file and is defined as follows: 

pfn - AUAPTF 

password - JJFWGR. • 
user no - ACXLIB 

The usage detail file is also maintained as a direct access 
permanent file and is defined as follows: 

pfn - AUADTF 

password - JJFWGR 
user no - ACXLIB 

Because of the importance of these files, every attempt 
has been made to ensure that they are not lost during a 
RANDR run due to some external job interruption. 
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During a RANDR run, two other permanent file names 
become associated with AUAPTF (PFNEW, PFTMP) 
and AUADTF (DFNEW, DFTMP). The passwords, etc., 
are the same. Completion of RANDR purges these working 
files; noncompletion of RANDR (e.g., parity error, 
system abort, unexpected operator intervention) may 
cause them to be left as part of the permanent file base. 

As a RANDR modifies product file entries, the file 
(AUAPTF) is being rewritten as PFNEW. DFNEW has 
multiple uses. PFTMP is the AUAPTF file renamed and 
represents the product file prior to the RANDR run. Like¬ 
wise, DFTMP represents the AUADTF file prior to the 
RANDR run. 


In the event of an external job interruption, the re¬ 
commended recovery procedure is to purge all files 
except the PFTMP and DFTMP files, change them to 
AUAPTF and AUADTF, respectively, and rerun RANDR. 
In the event that one or both of the xxTMP file(s) are not 
found, but the xxNEW file(s) are present no action is 
necessary other than to purge the xxNEW file(s) and rerun 
RANDR. 

It is further recommended that the site maintain adequate 
backup for these files (AUAPTF, AUADTF) through their 
DUMPF utility. 
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RELEASE DESCRIPTION 


XEDIT Version 3 (XEDIT 3) is an extended interactive 
text editor developed by the University of Minnesota. 


HARDWARE REQUIREMENTS 

XEDIT 3 can be maintained on the same minimum hard¬ 
ware configuration as NOS 1. The minimum field length 
to run XEDIT 3 is 12,000. 

o 

CORRECTIONS 

None. 


DEFICIENCIES 

None. 


RELEASE MATERIALS 


REL61 contains the XEDIT 3 release materials. It 
has the following characteristics: 7-track (800 bpi) 
or 9-track (800 or 1600 cpi), binary recording mode, 
VER3P0 as file ID in HDR1 label, six files: 

File 1 - installation/verification decks in UPDATE 
format, 

File 2 - absolute binary code and XEDIT Help file, 
File 3 - empty, 

File 4 - program library of XEDIT in MODIFY 
format, 

File 5 - verification test procedure, and 
File 6 - output produced by XEDIT test. 


INSTALLATION PROCEDURE 

XEDIT 3 is installed under user number LIBRARY by 
entering the following commands at the system console 
after mounting the XEDIT 3 release tape. 


X.DIS 

SUI(377776) 

jMT/ (800 ) 

LABEL(TAPE, D = j NT \ ,D= j1600 J ,VSN = REL61) 

UPDATE(Q, P=TAPE, OINSJOB, L=l, D, 8) 

*COMPILE INSJOB 
CALL, INSJOB(IOPT-l) 

-or- 

CALL, INSJOB(IOPT~2) 

If IOPT 1 is used, XEDIT 3 will be installed from the ABS 
binary code on file 2 of the release tape. 

If IOPT-2 is used, XEDIT 3 will be installed by assembling 
the XEDIT source on file 4 of the XEDIT 3 release tape. 

The XEDIT 3 installation procedure results in the following 
files added to the user number LIBRARY. 

File 1 - XEDIT - direct access file (XEDIT binary), 
and 

File 2 - XEDI64 - indirect access file (XEDIT help 
file). 


INSTALLATION PARAMETERS 


None. 


VERIFICATION PROCEDURE 


The XEDIT 3 verification procedure must be executed as a 
time-sharing origin (TXOT) type job. The following com¬ 
mands must be entered from a time-sharing terminal to 
execute the verification procedure. 

BAT. 

ATTACH, XEDIT/UN-LIBRARY. 

( MT ) ( 800 ) 

LABEL(TAPE, D= j NT [ ,D= j 1600j ,VSN = REL61) 

UPDATE(Q, P-TAPE, C-VFYJOB, L=1,D, 8) 

*COMPILE VFYJOB 
C ALL, VFYJOB. 

The verification procedure will execute the XEDIT test 
and compare the test results with the XEDIT output on file 
6 of the release tape. The results of the verification will 
be output to the terminal. 
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PDS/MAGEN 
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RELEASE DESCRIPTION 


PDS/MaGen runs under NOS to provide the user with 
matrix generating and report writing capabilities for 
use in conjunction with APEX-III. PDS/MaGen is de¬ 
signed to execute from permanent files. 


HARDWARE REQUIREMENTS 

PDS/MaGen requires the same minimum hardware con¬ 
figuration as NOS. A minimum field length of 7OK is 
required for installation. 

DEFICIENCIES 

None. 


RELEASE MATERIALS 

PDS/MaGen resides on the tape known as REL65. It has 
the following characteristics: 7-track (800 bits per inch 
CbpG ) or 9-track (800 or 1600 characters per inch 
QcpQ ), binary recording mode, PDSMAGENV1P3B as 
file ID in HDR1 label, and six files: 

File 1 - installation deck in UPDATE PL form. 

File 2 - absolute binaries of PDS/MaGen, 

File 3 - relocatable binaries of PDS/MaGen, 

File 4 - empty. 

File 5 - verification deck in UPDATE PL form, and 

File 6 - sample output from verification run. 

Listings of the installation deck and the verification deck 
may be obtained by executing the following job: 

LIST, T50. 

USER. (Supply valid USER card.) ( HY \ 

LABEL(0LDPL, R, L = PDSMAGENV1P3B, D= ] HD >, 
VSN = REL65) l PE ) 

UPDATE(F,*= = , L= 7) 

SKIPF (OLDPL, 4,17) 

UPDATE (F,* = =, L = 7, R) 

7/8/9 

6/7/8/9 


INSTALLATION PARAMETERS 

None. 


INSTALLATION PROCEDURE 

PDS/MaGen is installed by executing deck PDSMC1, con¬ 


tained on the first file of REL65. This job deck reads the 
PDS/MaGen system from REL65, installs an executable 
file of the PDS/MaGen system on a permanent file name 
PDS with the password PDS. 

The deck PDSMC1 contains UPDATE IF, DEF directives 
to simplify installation. The names used by these direc¬ 
tives and their meaning when DEFINED are as follows: 

Name Effect on Installation Job 

MT Uses 7-track, 800 bpi, 

magnetic tape 

HD Uses 9-track, 800 cpi, 

magnetic tape 

PE Uses 9-track, 1600 cpi, 

magnetic tape 

PDSMC1 may be extracted from REL65 and submitted for 
execution via the following job. Note that PDSMC1 re¬ 
quires a change for execution. A valid user card must 
be supplied. 

INST, T50. 

USER. (Supply valid USER card.) f HY ) 

LABEL(OLDPL, R, L = PDSMAGENV1P3B, D= | HD | , 
VSN = REL65) l PE ) 

UPDATE(Q,*= = , D, 8) 

SUBMIT(COMPILE, B) 

7/8/9 ( MT | 

= DEFINE | HD \ 
l PE ) 

= D, PDSMC1.3 

USER. (Supply valid USER card.) 

=C,PDSMC1 

7/8/9 

6/7/8/9 


INSTALLATION VERIFICATION 

The following job may be used to extract job PDSMCV 
from REL65 and submit for execution to verify installation 
of PDS/MaGen. 

VER, T50. 

USER. (Supply valid USER card.) ( HY \ 

LABEL(OLDPL, R, L = PDSMAGENV1P3B, D= j HD > , 
VSN = REL65) l PE J 

SKIPF(OLDPL, 4,17) 

UPDATE (Q,*= = , D, 8, R) 

SUBMIT(COMPILE, B) 

7/8/9 

= D, PDSMCV.3 

USER. (Supply valid USER card.) 

=C,PDSMCV 

7/8/9 

6/7/8/9 

File 6 of REL65 can be copied to OUTPUT and used to 
validate correct execution of the verification run. 
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INTRODUCTION 


1 


INSTALLATION AND MODIFICATION 


Application 


Tape Section 


Part II presents information pertaining to the installation 
of applications software under NOS/BE. While the infor¬ 
mation in this section describes the application installa¬ 
tion, users should reference the f ’Introduction” to NOS/BE 
Installation Handbook for additional information. 

The application products presented are intended for use 
only as described in this part. Control Data cannot be 
responsible for the proper functioning of undescribed 
features or parameters. 


RELEASE TAPES 

The following application products are available under 
NOS/BE: 


Application 

Tape 

Section 

APEX III 

Out-of-Core 

System 1 

PL45 

2 

APEX III 

Mixed Integer Programming- 
Option 

PL51 

2 

APEX III 

Matrix Reduction Option 

PL52 

2 

apex in 

Parametrics Option 

PL53 

2 

APEX III 

Usage Package 1 

PL84 

2 

APT IV 2 

PL59A 

3 

GPSS V/6000 1.2 

PL35 

4 

IMSL 6 

PL87 

5 

LCGT/IGS 2 

PL67 

6 

PERT/TIME 2 

PL85 

7 

777/IGS V2 Host 

PL40 

8 

777/IGS V2 Remote 

PL41 

8 

777/IGS V2 
with 3D (Host) 

PL46 

8 

777/IGS V2 
with 3D (Remote) 

PL47 

8 

SIMSCRIPT I. 5 3 

PL27 

9 


TIGS 1 

PL86A 

10 

Tektronix 401X Post 
Processor under TIGS 

PL86B 

10 

Sanders Graphic 7 Post 
Processor under TIGS 

PL86C 

10 

TOTAL Universal 1 

PL49 

11 

TOTAL Universal 2 

PL75 

11 

TOTAL/ATHENA 

PL62 

12 

UNIPLOT 2 

PL71 

13 

Usage Accounting Utility 

AP001B 

14 


RELATED DOCUMENTATION 

The following manuals contain relevant information on 
NOS/BE and/or the application products described in 
part II. 


Title 


Publication No. 


NOS/BE Installation Handbook 
APEX III Reference Manual 
Application Executive Reference Manual 
APT IV V2 Reference Manual 


60494300 

76070000 

17322200 

17326900 


APT IV Internal Maintenance Specification 

Beginning Graphics Users Guide 

Data Handier Reference Manual 

GPSS V/6000 General Information Manual 

IMSL Reference Manual (Volumes 1-2) 

LCGT/IGS Reference Manual 

LCGT/IGS User’s Guide 

PERT/TIME General Information Manual 

PERT/TIME Reference Manual 

777/IGS Reference Manual 

777 IGS Remote Job Entry User Guide 

777 IGS User Guide 

777/3D IGS Reference Manual 

SIMSCRIPT I. 5 Reference Manual 


76077300 
17322100 
84003900 
SMD150043' 
76079100 
76077400 
60133300 
60133600 
17321800 
76077200 
17322500 
17326500 
60358500 


TIGS VI Reference Manual 


60455940 


TOTAL Universal Reference Manual 
UNIPLOT User Guide 
Usage Accounting Utility 
1743-1 Reference Manual 


76070300 

76079600 

84000440 

89638400 


I'These manuals may be ordered by title from Control Data Corporation, Software Manufacturing and Distribution, 4201 
North Lexington Avenue, St. Paul, Minnesota 55112. 


76071100 S 


II-1-1 




APEX-III PRODUCT OPTIONS 


2 


APEX-III OUT-OF-CORE SYSTEM 1 


RELEASE DESCRIPTIONS 

APEX-III Out-of-Core System 1 runs under the NOS/BE 
operating system. The FORTRAN Extended compiler is 
required for compiling APEX-III. APEX-III Out-of-Core 
System 1 is designed to execute from permanent files. 

Hardware Requirements 

APEX-III Out-of-Core System 1 requires the same mini¬ 
mum hardware configuration as NOS/BE except that a 
minimum field length of 100K octal is required to compile 
the system and a minimum of 64K octal is required to 
execute APEX-III. 

Deficiencies 

None. 


Release Materials 

APEX-III Out-of-Core System 1 resides on the tape known 
as PL45, in either 7-track (800 bpi) or 9-track (800 or 
1600 cpi) format, has label OOCAPEXIIIV1P1 and contains 
six binary files. 

File 1 - installation deck in UPDATE PL form, 

File 2 - empty, 

File 3 - empty, 

File 4 - source code in UPDATE PL form, 

File 5 - verfication deck in UPDATE PL form, and 
File 6 - sample output from verification run. 

Listings of the installation deck (APEXC1) and the verifi¬ 
cation deck (APEXCV) may be obtained from PL45 by 
executing the following job: 

[MT1] 

LIST, |HDl| . 
iPElj 

ACCOUNT. (Supplv valid ACCOUNT card.) 

| HY ) 

LABEL(OLDPL,R, L=OOCAPEXIIIVlPl,D= l HD > , 

(peJ 

VSN=APXOOC) 

UPDATE(F, *==, L-7) 

SKIPF (OLDPL, 4, 17) 

UPDATE(F, *==, L-7, R) 

7/8/9 
6/7/8/9 

INSTALLATION PARAMETERS 


INSTALLATION PROCEDURE 

APEX-III Out-of-Core System 1 is installed by executing 
deck APEXC1, contained on the first file of PL45. This 
job deck reads the APEX-III system from PL45, compiles 
the system, and installs an executable file of the APEX-III 
system on a permanent file named APEXIII with the 
ID APEX. 

This job deck also creates three permanent files which are 
needed when one uses the APEX-III USER feature. 
(Reference the APEX-III Reference Manual for detailed 
information.) For those installations where the USER 
feature is used infrequently, it may be desirable to main¬ 
tain these three files on magnetic tape rather than perma¬ 
nent files. These three files are described below: 


Name 

ED 

Contents 

APEXPL 

APEX 

Partial APEX-III source 

code. Contains APEX-III 
COMMON regions and sub¬ 
routines QBUFFER, OGET 
QUSER, andOUSERDA. 

APEXOV 

APEX 

Relocatable binary code of 
APEX-III overlay drivers. 

APEXRL 

APEX 

Relocatable binary code of 
remaining APEX-III 
subroutines. 


For those installations which have purchased any of the 
APEX-III options, deck APEXC1 may also be used to install 
the APEX-III Out-of-Core System 1 with any combination of 
the APEX-III Mixed Integer Programming Option (MIP), 
APEX-III Matrix Reduction Option, and APEX-III 
Parametrics Option. 

The deck APEXC1 contains UPDATE IF,DEF directives to 
simplify installation. The names used by these directives 
and their meaning when DEFINEd are as follows: 

Name Effect on Installation -lob 

MT Uses 7-track magnetic tapes. 

IID Uses 9-track, s()() cpi, magnetic tapes. 

PE Uses 9-track; 1(500 cpi, magnetic tapes. 

MIP APEX-III Mixed Integer Programming Option 

is installed with APEX-III Out-of-Core 
System 1. 

RED APEX-III Matrix Reduction Option is installed 

with APEX-III Out-of-Core System 1. 


None. 
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Name Effect on Installation Job 

PAR APEX-III Parametrics Option is installed with 

APEX-III Out-of-Core System 1. 

CYB176 Required when installing on a CYBER 176. 

APEXC1 may be extracted from PL45 and submitted for 
execution via the following job. Note that APEXC1 re¬ 
quires a change for execution. A valid ACCOUNT card 
must be supplied. 

{ MTlj 
HD1 1 . 

PEI j 

ACCOUNT. (Supply valid ACCOUNT card.) 

f HY ! 

LABEL(OLDPL, R, L-OOCAPEXIIIV1P1, D- l HD > , 

(pe) 

VSN-A PXOOC) 

REQUEST, COMPILE, *Q. 

UPDATE(Q, D, 8) 

ROUTE (COMPILE, DC-IN) 

7/8/9 

|MT] 

-DEFINE <HD | 

IPE j 

-DEFINE MIP (If Mixed Integer Programming 
Option.) 

-DEFINE RED (If Matrix Reduction Option.) 

-DEFINE PAR (If Parametrics Option.) 

-DEFINE CYB176 (If installing on a CYBER 176.) 

-D, APEXC1. 8 

ACCOUNT. (Supply valid ACCOUNT card.) 

=C, APEXC1 

7/8/9 

6/7/8/9 


UPDATE(Q, , D, 8, R) 

ROUTE (COMPILE, DC-IN) 

7/8/9 

-D, APEXCV. 3 

ACCOUNT. (Supply valid ACCOUNT card.) 

=C, APEXCV 

7/8/9 

6/7/8/9 

File 6 of PL45 can be copied to OUTPUT and used to 
validate correct execution of the verification run. 

APEX-III MIXED INTEGER PROGRAMMING 
OPTION (MIP) 

RELEASE DESCRIPTIONS 

The APEX-ni Mixed Integer Programming Option runs 
under NOS/BE when installed with APEX-III Out-of-Core 
System 1. The FORTRAN Extended compiler is required 
for compiling and updating APEX-III MIP. APEX-III MIP 
is designed to execute from permanent files. 

Hardware Requirements 

APEX-III MIP requires the same minimum hardware con¬ 
figuration as NOS/BE except that a minimum field length 
of 100K octal is required to compile the system and a 
minimum of 64K octal is required for execution. 

Deficiencies 

None. 


Error Messages 

A nonfatal loader error will be encountered in loading the 
APEX-III system. The error message is of the form: 

NE4102///DUPLICATE ENTRY POINT NAME-EXIT 

PROGRAM NAME-FORSYS^ 

LAST FILE ACCESSED - FORTRAN 

Errors of any other form should be investigated. 


Installation Verification 

The following job may be used to extract job deck APEXCV 
from PL45 and submit for execution to verify installation 
of APEX-III Out-of-Core System 1. 

{ MTlj 
HD1 | . 

PEI) 

ACCOUNT. (Supply valid ACCOUNT card.) 

m Y v 

LABEL(OLDPL,R, L-OOCAPEXIIIV1P1, D- <HD[ , 

(pe) 

VSN-A PXOOC) 

SKIPF (OLDPL,4,17) 

REQUEST, COMPILE, *Q. 


Release Materials 

The APEX-m MIP resides on the tape known as PL51. 
PL51, in either 7-track (800 bpi) or 9-track (800 or 1600 
cpi) format, has label MIPAPEXIIIV1P1 and contains six 
binary files. 

File 1 - not used. 

File 2 - empty. 

File 3 - empty, 

File 4 - source code in UPDATE PL form, 

File 5 - verification deck in UPDATE PL form, and 
File 6 - Sample output from verification run. 

A listing of the verification deck (APEXMV) may be 
obtained from PL51 by executing the following job: 

| MTlj 

LIST, IhDiJ . 
iPEl] 

ACCOUNT. (Supplv valid ACCOUNT card.) 

f HY | 

LABEL(OLDPL,R, L-MIPAPEXIIIV1P1,D- |Hd| , 

(pe/ 

VSN-A PXMIP) 

SKIPF (OLDPL, 4,17) 

UPDATE (F, *-=, L-7, R) 

7/8/9 

6/7/8/9 


4 

■% 


II—2 —2 


76071100 M 




INSTALLATION PARAMETERS 

None. 


INSTALLATION PROCEDURE 

The APEX-III MIP must be installed with APEX-III Out-of- 
Core System 1. The installation deck, APEXC1, on the 
APEX-III Out-of-Core System 1 tape, known as PL45, is 
used to install the MIP Option. The name MIP is defined 
for the UPDATE IF,DEF directives in deck APEXC1 to 
merge the MIP Option with the out-of-core system. 


Hardware Requirements 

APEX-in REDUCE requires the same minimum hardware 
configuration as NOS/BE except that a minimum field 
length of 100K octal is required to compile the system and 
a minimum of 64K octal is required for execution. 

Deficiencies 

None. 

Release Materials 


(Reference ’’Installation Procedure” for APEX-III Out-of- 
Core System 1 for details of installation and expected 
error messages. ) 


The APEX-III Matrix Reduction Option resides on the tape 
known as PL52. PL52, in either 7-track (800 bpi) or 

9-track (800 or 1600 cpi) format, has label 
REDAPEXIIIV1P1 and contains six binary files. 


Installation Verification 

The following job may be used to extract job deck APEXMV 
from PL51 and submit for execution to verify installation 
of the MIP Option. 


File 1 - not used, 

File 2 - empty, 

File 3 - empty, 

File 4 - source code in UPDATE PL form, 

File 5 - verification deck in UPDATE PL form, and 
File 6 - sample output from verification run. 


[MTlj 

VER, |hDi| . 

Ipei) 

ACCOUNT. (Supply valid ACCOUNT card.) 

( HY ) 

LABEL(OLDPL, R, L^MIPAPEXIIIV1 PI, D- j HD > 

Ipe] 

VSN-APXMIP) 

SKIPF (OLDPL, 4, 17) 

REQUEST, COMPILE, *Q. 

UPDATE (Q, *•■= = , D, 8, R) 

ROUTE (COM PI LE, DC -IN) 

7/8/9 

=D, APEXMV. 3 

ACCOUNT. (Supply valid ACCOUNT card.) 

=C, APEXMV 

7/8/9 

G/7/8/9 


A listing of the verification deck (APEXRV) may be 
obtained from PL52 by executing the following job: 


fMTl) 

HD1} 

Ipei 

account. 


LIST, 


) 


(Supply valid ACCOUNT card.) 


LABEL(OLDPL, R, L-REDAPEXIIIV1P1, D- 



VSN-A PXRED) 
SKIPF (OLDPL, 4, 17) 
UPDATE(F, *=-, L-7, R) 
7/8/9 
G/7/8/9 


INSTALLATION PARAMETERS 


None. 

File 6 of PL51 can be copied to OUTPUT and used to 
validate correct execution of the verification run. 

INSTALLATION PROCEDURE 


APEX-III MATRIX REDUCTION OPTION 
(REDUCE) 

RELEASE DESCRIPTIONS 

The APEX-III Matrix Reduction Option runs under the 
NOS/BE operating system when installed with APEX-III 
Out-of-Core System 1. The FORTRAN Extended compiler 
is required for compiling and updating APEX-III REDUCE. 
APEX-III REDUCE is designed to execute from permanent 
files. 


The APEX-III Matrix Reduction Option must be installed 
with APEX-III Out-of-Core System 1. The installation 
deck, APEXC1, on the APEX-III Out-of-Core System 1 
tape known as PL45, is used to install the REDUCE 
Option. The name RED is defined for the UPDATE IF, 
DEF directives in deck APEXC1 to merge the REDUCE 
Option with the out-of-core system. 


(Reference ’’Installation Procedure” for APEX-III Out-of- 
Core System 1 for details of installation and expected 
error messages.) 
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Installation Verification 


The following job may be used to extract job deck APEXRV 
from PL52 and submit for execution to verify installation 
of the REDUCE Option. 


(MT1 
HD1 
l PEI 
ACCOUNT. 


VER, 


(Supply valid ACCOUNT card.) 


HY] 

LABEL(OLDPL, R, L=REDAPEXIIIV1 PI, D= HD 1 , 

PE ) 


VSN-APXRED) 

SKIPF (OLDPL, 4,17) 

REQUEST, COMPILE, *Q. 

UPDATE(Q, *==, D, 8, R) 

ROUTE (COMPILE, DCMN) 

7/8/9 

=D, APEXRV. 3 

ACCOUNT. (Supply valid ACCOUNT card.) 

-C, APEXRV 

7/8/9 

6/7/S/9 


File 6 of PL52 can be copied to OUTPUT and used to 
validate correct execution of the verification run. 


File 1 - not used, 

File 2 - empty. 

File 3 - empty. 

File 4 - source code in UPDATE PL form, 

File 5 - verification deck in UPDATE PL form, and 
File 6 - sample output from verification run. 

A listing of the verification deck (APEXPV) may be 
obtained from PL53 by executing the following job: 

(MTlj 

LIST, |hDi| . 

IPElJ 

ACCOUNT. (Supply valid ACCOUNT card.) 

( HY ) 

LABEL(OLDPL,R,L=PARAPEXinVlPl,D= |hd| , 

(pe) 

VSN-APXPAR) 

SKIPF (OLDPL, 4,17) 

UPDATE (F, *==, L=7, R) 

7/8/9 

G/7/8/9 


INSTALLATION PARAMETERS 


None. 


APEX-III PARAMETRICS OPTION 


RELEASE DESCRIPTIONS 

The APEX-III Parametrics Option runs under the NOS/BE 
operating system when installed with APEX-III Out-of-Core 
System 1. The FORTRAN Extended compiler is required 
for compiling and updating APEX-III Parametrics. 

APEX-III Parametrics is designed to execute from per¬ 
manent files. 


Hardware Requirements 

APEX-III Parametrics requires the same minimum hard¬ 
ware configuration as NOS/BE except that a minimum field 
length of 100K octal is required to compile the system and 
a minimum of 64K octal is required for execution. 

Deficiencies 

None. 

Release Materials 


The APEX-III Parametrics Option resides on the tape 
known as PL53. PL53, in either 7-track (800 bpi) or 
9-track (800 or 1600 cpi) format, has label 
PARAPEXIIIV1P1 and contains six binary files. 


INSTALLATION PROCEDURE 

The APEX-III Parametrics Option must be installed with 
APEX-III Out-of-Core System 1. The installation deck, 
APEXC1, on the APEX-III Out-of-Core System 1 tape 
known as PL45, is used to install the Parametrics Option. 
The name PAR is defined for the UPDATE IF,DEF direc¬ 
tives in deck APEXC1 to merge the Parametrics Option 
with the out-of-core system. 

(Reference ’’Installation Procedure” for APEX-III Out-of- 
Core System 1 for details of installation and expected 
error messages.) 

Installation Verification 

The following job may be used to extract job deck 
APEXPV from PL53 and submit for execution to verify 
installation of the Parametrics Option. 

1 MT1 ] 

HD1 | . 

PEI j 

ACCOUNT. (Supply valid ACCOUNT card.) 

HYj 

LABEL(OLDPL,R, L^PARAPEXIIIVIPI, D- J HD J , 

l PE ) 

VSN=APXPAR) 

SKIPF (OLDPL, 4,17) 

REQUEST, COMPILE, *Q. 

UPDATE(Q, *==,D, 8, R) 


/I 

i 
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ROUTE (COMPILE, DC-IN) 

7/8/9 

-D, APEXPV. 3 

ACCOUNT. (Supply valid ACCOUNT card.) 

=C, APEXPV 

7/8/9 

G/7/8/9 


File 6 of PL53 can be copied to OUTPUT and used to 
validate correct execution of the verification run. 


APEX-III USAGE PACKAGE 1 


RELEASE DESCRIPTIONS 

APEX-III Usage Package 1 runs under the NOS/BE 
operating system. The FORTRAN Extended compiler is 
required for compiling APEX-III when using the USER 
feature. APEX-III is designed to execute from permanent 
files. 

Installation of APEX-III Usage Package 1 requires that the 
Usage Accounting Utility be installed and that a product 
update run be made to add the APEX-III product to the 
accounting files. (Consult the Usage Accounting Utility 
Reference Manual for further details.) 

The product activity card required for APEX-III has the 
following form: 


^ CDAPEX III A A 4 APEX 


Columns 


Contents 


1 to 2 
3 to 12 
14 


16 

18 

20 to 23 j 
25 to 28 i 

30 to 80 


CD is the vendor code. 

APEX III is the product name. 

A signifies add product information to 
product name file. 

A signifies the product is active. 

4 is the ID value. 

Represent threshhold values-consult Usage 
Accounting Utility Reference Manual if 
usage of APEX-III is to be limited. 

APEX is the software code. 


Hardware Requirements 


APEX-III Usage Package 1 requires the same minimum 
hardware configuration as NOS/BE except that a minimum 
field length of 10OK octal is required for compilation for 
the USER feature and 70K octal is required for execution 
of APEX-III. 


Deficiencies 

None. 


Release Materials 


APEX-III Usage Package 1 resides on the tape known as 
PL84. PL84, in either 7-track (800 bpi) or 9-track (800 

or 1600 cpi) format, has label AUUAPEXIIIV1P1 and con¬ 
tains seven binary files. 

File 1 - installation deck in UPDATE PL format, 

File 2 - relocatable binary code of APEX-III overlay 
drivers, 

File 3 - relocatable binary code of remaining 
APEX-III system routines, 

File 4 - partial source code in UPDATE PL form for 
USER feature, 

File 5 - verification deck in UPDATE PL form, 

File 6 - sample output from verification deck, and 
File 7 - list file of documentation of selected 
APEX-III routines for USER feature. 


Listings of the installation deck (APEXU1) and the verifi¬ 
cation deck (APEXUV) may be obtained from PL84 by 
executing the following job: 


I MTlj 
HD1V . 

PEI) 

ACCOUNT. (Supply valid ACCOUNT card.) 


LABEL(OLDPL,R,L=AUUAPEXIIIVlPl,D= 


HY 

HD 

PE, 


VSN-A PXAUU) 
UPDATE(F, *-=, L 7) 
SKIPF (OLDPL, 4, 17) 


UPDATE(F, *==, L 7, R) 

7/8/9 

G/7/8/9 


INSTALLATION PARAMETERS 

None. 


INSTALLATION PROCEDURE 

APEX-in Usage Package 1 is installed by executing deck 
APEXU1, contained on the first file of PL84. This job 
deck reads relocatable binary code of the APEX-III system 
from PL84 and installs an executable file of the APEX-III 
system on a permanent file named UAPEX3 with ID^APEX. 

This job deck will optionally create three permanent files 
which are needed when one uses the APEX-III USER 
feature. (See the APEX-III Reference Manual for detailed 
information.) For those installations where the USER 
feature is used infrequently, it may lx? desirable to refer¬ 
ence these files directly from the installation tape when 
needed rather than maintaining them on permanent files. 
These three files are described as follows: 


76071100 N 


II—2—5 



Name 

ID 

Contents 

UAPEXPL 

APEX 

Partial APEX-III source code 
Contains APEX-III COMMON 
regions and subroutines 
QBUFFER, QGET, QUSER 



and QUSERDA. Same as 
file 4 of installation tape. 

UAPEXOV 

APEX 

Relocatable binary code of 
APEX-III overlay drivers. 
Same as file 2 of installation 
tape. 


ROUTE (COMPILE, DC-IN) 
7/8/d 


I MT I 

HD 1 

PE | 

-DEFINE PF 
-DEFINE CYB176 


(If files for USER feature are to be 
on permanent files.) 

(If installing on a CYBER 176.) 


-D, APEXU1.8 

ACCOUNT. (Supply valid ACCOUNT card.) 

-C, APEXU1 

7/8/9 

6/7/8/9 


UAPEXRL APEX Relocatable binary code of 

remaining APEX-III sub¬ 
routines. Same as file 3 of 
installation tape except that 
record 2 is ignored for a 
CYBER 176; record 1 is 
ignored for other mainframes. 

The deck APEXU1 contains UPDATE IF,DEF directives to 
simplify installation. The names used by these directives 
and their meaning when DEFINED are as follows: 



Error Messages 

A nonfatal loader error will be encountered in loading the 
APEX-III system. The error message is of the form: 

NE4102///DUPLICATE ENTRY POINT NAME - EXIT 

PROGRAM NAME-FORSYS= 

LAST FILE ACCESSED- FORTRAN 

Errors of any other form should be investigated. 


Name 


Effect on Installation Job 


Installation Verification 


MT Uses 7-track magnetic tapes. 

HD Uses 9-track, 800 cpi magnetic tapes. 


The following job may be used to extract job deck APEXUV 
from PL84 and submit for execution to verify installation 
of APEX-III Usage Package 1: 


PE Uses 9-track, 1600 cpi, magnetic tapes. 

PF Files 2, 3, and 4 of the installation tape are 

installed as permanent files with names 
UAPEXOV, UAPEXRL, and UAPEXPL re¬ 
spectively for the USER feature. 

CYB176 Required when installing on CYBER 176. 

APEXU1 may be extracted from PL84 and submitted for 
execution via the following job. Note that APEXU1 re¬ 
quires a change for execution. A valid ACCOUNT card 
must be supplied. 

I MTlj 
HD1 l . 

PEI I 

ACCOUNT. (Supply valid ACCOUNT card.) 

| HY l 

LABEL(OLDPL,R,L=AUUAPEXIIIVlPl,D= < HD > , 

l peJ 

VSN=APXAUU) 

REQUEST, COMPILE, *Q. 

UPDATE (Q,*==,D, 8) 


I MTlj 
HD1 i . 

PEI j 

ACCOUNT. (Supply valid ACCOUNT card.) 

M 

LA BE L (O LD PL, R, L-A UUA PEXIIIV1 PI, D- < HD > 

l p Ej 

VSN-APXAUU) 

SKIPF (OLDPL, 4,17) 

REQUEST, COMPILE, *Q. 

UPDATE(Q, *==, D, 8, R) 

ROUTE (COMPILE, DC-IN) 

7/8/9 


-D, APEXUV. 3 

ACCOUNT. (Supply valid ACCOUNT card.) 

-C, APEXUV 
7/8/9 
6/7/8/9 


File 6 of PL84 can be copied to OUTPUT and used to 
verify correct execution of the verification run. 
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APT IV 2 


3 


RELEASE DESCRIPTION 


APT IV Version 2 (APT IV 2) is a numerical control 
language processor designed to generate cutter location 
coordinates. The user has the capability to fully describe 
the part to be machined and then drive the tool along the 
chosen path. The output from APT IV 2 is a verification 
listing and a file for input to a post processor. APT IV 2 
has all the capabilities of APT IV in addition to new 
language features and extensions. 

APT IV 2 runs under the NOS/BE operating system on a 
CDC host computer having at least 65,000 words of 
central memory. 

RELEASE MATERIALS 

APT IV 2 resides on the tape known as PL59A. This re¬ 
lease tape contains six files: 

File 1 - installation/maintenance program library, 

File 2 - absolute modules of the APT IV 2 system. 

The file should be placed on the system library if the 
user does not wish to modify the APT IV processor. 
File 3 of PL59A was used to make file 2. 

File 3 - relocatable binary records of all routines 
needed for the standard mode; included are the binary 
records, COD4, PRD4, PTR4, P004 and C004 which 
are produced by the LOAD COMPLEX. This file is 
ready to be loaded by the host computer system and 
will produce the absolute modules contained on file 2. 

File 4 - program library in UPDATE format. Fol¬ 
lowing the YANK$$$ deck, the first 67 decks, 

TAPEOP through ZSSPICT, are common decks called 
by one or more of the succeeding decks. The next 
16 decks, LLDM through LBCDBIN, are the LOAD 
COMPLEX. The next deck, LLCDATA, is data used 
by the LOAD COMPLEX routines. The next 93 decks, 
TAPT4T through T LOAN ON, are the TRANSLATOR. 
The next 378 decks, XAPT4E through XTRANSF57 are 
the EXECUTION COMPLEX. The next 45 decks, 
CAPT4C through CTAPEWT are the CLEDITOR. 

The last 18 decks, PAPT4P through PTAPEWT are 
the POST EXEC. 

File 5 - Sample part program. Job control cards are 
provided for correct operation with system overlays 
resident in the system library, permanent files, or 
user library. 

File 6 - Listing of the sample job, not including the 
dayfile. 


INSTALLATION REQUIREMENTS 


The system has four general modes of operation: 

1. Standard mode - offers all capabilities except 
parametric and sculptured surfaces. This mode 
requires approximately 110, 000g words of field 
length to build the system and for execution. 

2. Parametric surface mode - offers all capabilities 
of the standard system plus the added features of 
parametric surface processing. This mode does 
not include sculptured surface processing. Ap¬ 
proximately 110,000g words are required to build 
the system and (110, 000 plus the length of the 

O 

FORTRAN parametric surface routines) words 
for execution. 

3. Sculptured surface mode - offers all capabilities 
of the standard system plus the added features of 
sculptured surfaces processing. This mode does 
not include parametric surface processing. Ap¬ 
proximately 125,000g words are required to build 
and execute the system. 

4. Parametric and sculptured mode - both parametric 
and sculptured surface processing may be used. 
Approximately 125, 000g words are required to 
build the system and (125,000g plus the length of 
the FORTRAN Parametric Surface routine) words 
for execution. 


INSTALLATION OPTIONS 

The user may choose one of four modes: 

1. Parametric surface, 

2. Sculptured surface, 

3. Parametric and sculptured surface, and 

4. Neither parametric nor sculptured surface. 

The release system operates with neither parametric nor 
sculptured surfaces. 

In addition to the above mode, the user may choose one of 
three residences for the APT system: 

1. system library, 

2. permanent files, or 

3. user library. 
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The released system operates from the system library. 

The user may wish to have PSRs installed and/or local 
modifications incorporated. 


PSR MODIFICATION 

The PSR deck on the corrective code tape which is appli¬ 
cable to APT IV 2 is APT. The idents within this deck 
are of the form APTnnnn. The initial rerelease of PL59A 
is at LV420. 

The APT IV V2 installation job assumes that the PSRs are 
on a permanent file called MINIT, ID=CCT. MINIT is as¬ 
sumed to be a program library with a master character 
of / (slash). 


INSTALLATION PROCEDURES 


STAN. 


MT1. 
HD1. J 


ACCOUNT. 

LA BE L (OLDP L, R,L=APT4V2, D= I M , 
VSN=PL59A) ' H ° ’ 

UPDATE(Q, *=$$$$,D, 8) 

ROUTE (COMPILE, DC=IN) 

7/8/9 

$/ (If using a 9-track tape 

insert the following:) 

$IDENT NOSBE4 
$DELETE STANDECK. 10 
MAPT03.HD1. 

$/END IF 

$IDENT, DE C KSE LC 

$DELETE,STANDECK. 11 (To change ACCOUNT 
ACCOUNT. cards as needed.) 

SDEFINE, ( JJJ ) 

$DEFINE, STANDARD 
$COMPILE, STANDECK 
6/7/8/9 


The following control cards may be used to obtain a listing If the user selects to install the standard system, the user 

of the installation decks from PL59A: must be prepared to do system EDITLIBs. 


LIST, 


MT1. 

HD1. 

ACCOUNT. 

LABEL(OLDPL, R, L=APT4V2, D= 
VSN-PL59A) 


UPDATE(F, *=$$$$, L=A1247) 

7/8/9 

6/7/8/9 


HY 

HD ’ 


The user defines MT for 7-track and NT for 9-track. If 
neither MT nor NT is defined, the APT installation as¬ 
sumes NT. 


MODIFICATION OF THE LOAD COMPLEX 
ROUTINES 


The following DEFINE options are specifiable in the in¬ 
stallation decks: 

( STANDARD 
COMPLEX 

SYSTEM, \ , MT 

PERMFILE, | (PSR,) (SSSURF,|{PARSURF| J 

USERLIB, ' > 1 


STANDARD APT SYSTEM INSTALLATION 


The standard APT IV 2 system is on file 2 of the release 
tape, PL59A. The standard APT system is installed into 
the host computer operating system via an EDITLIB 
(SYSTEM). The standard APT system does not include 
parametric or sculptured surfaces. 

The selection of the standard APT system precludes the 
selection of any and all other parameters except MT/NT. 
The UPDATE deck to perform the installation of the 
standard system is as follows: 


The deck COMPLEX may be used to modify the five re¬ 
locatable decks produced by the LOAD COMPLEX. The 
names of the decks are COD4, PRD4, PTR4, P004, and 
C004. Once the user modifications are determined and 
inserted, the deck COMPLEX compiles the LOAD 
COMPLEX routines LLDM through LBCDBIN. The deck 
LCCDATA, which is to be modified by the user, is the 
input data for the LOAD COMPLEX execution. The output, 
five FORTRAN BLOCK DATA routines, is then compiled 
and the relocatable decks replace their counterparts on 
file 3 of the new release tape. 

Next, the user should complete the installation of the APT 
system by running a second job to specify any other instal¬ 
lation option. 

NOTE 

Use of the COMPLEX option precludes 
the use of the standard option in this next 
job. 

The deck SOURCDK will be used to complete the installation 
using the output tape of the previous job as the OLDPL for 
this next job. 
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A sample procedure to install modifications to the LOAD 
COMPLEX routines is as follows: 


COMPLX, 


IIY 
HD 


MT1. 

HD1. 

ACCOUNT. 

LABEL(OLDPL, R, L-APT4V2, D= 

VSN-PL59A) 

UPDATE(Q, *-$$$$, D, 8) 

ROUTE (COMPILE, DC-IN) 

7/8/9 

$/ (If using 9-track tape 

insert the following:) 

$IDENT NOSBE4 
$DELETE COMPLEX. 7 
MAPT01, HD2, T200. 

$/END IF 

$IDENT, COMPMOD 
$DELETE, COMPLEX, i 
ACCOUNT. 

[ MT 

$DEFINE, 

’ I NT 

$DEFINE, COMPLEX 

$INSERT, COMPLEX. 65 

*IDENT, COMPLX 

♦INSERT, LITL. 43 

C I MODIFIED THIS WITH A COMMENT CARD 

(Insert mods here as 


(To change ACCOUNT 
cards as needed.) 


♦COMPILE, LITL 
$ INSERT, COMPLEX, 67 
♦IDENT, LCMOD 
♦DELETE,LLCDATA.2 
, (15 spaces) 1000 
♦COMPILE, LLCDATA 
$COMPILE, COMPLEX 
6/7/8/9 


needed.) 


(Insert mods to LLCDATA 
here as needed.) 


Before proceeding to the next job, review the results of 
this job to be sure that the intended modifications have 
been made correctly. 


NONSTANDARD APT SYSTEM INSTALLATION 


To perform nonstandard installation, the user: 

1. must not select the option standard and 

2. must not select the option COMPLEX during 
this run. 

The user may, however, have selected COMPLEX for the 
previous run to generate a new input tape for this job. 

The DEFINE options available for a nonstandard installa¬ 
tion are: 


( SYSTEM, J 

PERMFILE, > {PSR, J (SSSURF,) 
USERLIB, j 


j PARSURF,) 


MT 
NT , 


The user may select only one of SYSTEM, PERMFILE or 
USERLIB to specify whether the APT system is installed 
in the system library, as permanent files or as a user 
library. 

The deck SOURCDK is used to install the nonstandard APT 
system. 

In addition to selecting the type of residency, the user may 
DEFINE: 


1. PSR - PSR code is to be installed and resides 

on the permanent file MINIT,ID r ~CCT 
as described earlier. 

2. SSSURF - the sculptured surface features is 

installed. 

3. PARSURF - the parametric surface feature is 

installed. 

Local modifications may be installed (no DEFINE needed) 
by inserting the mods into SOURCDK at the obvious place 
(look at the listing of SOURCDK at line 170). 

Any combination of the above may be installed. 


SAMPLE INSTALLATION RUNS 

To install APT with parametric surfaces into the system 
library: 


INSTAL, 


| MT1. 
(HD1. 


ACCOUNT. 


LABEL(OLDPL, R, L=APT4V2, D= 


VSN-PL59A). 
UPDATE(Q, * : -$$$$, D, 8) 



ROUTE(COMPILE, DC-IN) 

7/8/9 

$/ (If using a 9-track tape, 

insert the following:) 

$IDENT NOSBE4 
SDELETE SOURCDK.7 
MAPT02, HD2, T2500. 

S/END IF 
$IDENT,SELECDK 

SDELETE,SOURCDK. 8 (To change ACCOUNT cards 

ACCOUNT. as needed.) 

i MT I 
SDEFINE, { nt J 

SDEFINE, SYSTEM 
$DEFINE, PARSURF 
$COMPILE, SOURCDK 
6/7/8/9 


To install APT with sculptured surfaces, parametric 
surfaces, PSRs and local modifications onto permanent 
files: 
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INSTAL, 


MT1.) 
HD1. ) 


ACCOUNT. 

LABEL(OLDPL,R, L=APT4V2,D= 

VSN=PL59A) 

UPDATE(Q, *=$$$$, D, 8) 

ROUTE (COMPILE, DC =IN) 

7/8/9 

$/ 

$IDENT NOSBE4 
$DELETE SOURCDK.7 
MAPT02,HD2,T2500. 

$/END IF 
$IDENT, SELECDK 
$DELETE, SOURCDK. 8 
ACCOUNT. 

$DEFINE, j j 

$DEFINE,SSSURF 
$DEFINE, PARSURF 
$DEFINE, PSR 
$DEFINE, PERMFILE 
$INSERT, SOURCDK. 170 
*INSERT, TCILOUT.4 
C MODIFY TCILOUT WITH A COMMENT CARD; 

A SAMPLE LOCAL MOD 
^COMPILE, TCILOUT 
$COMPILE, SOURCDK 
6/7/8/9 


(If using 9-track tape, 
insert the following;) 


(To change ACCOUNT 
cards as needed.) 



VERIFICATION PROCEDURE 


LIST, 


MT1.1 
HD1. 

ACCOUNT. 

LABEL(PL59A,R,L=APT4V2,D= 

VSN-PL59A) 

SKIPF(PL59A,4,17) 
COPYBF(PL59A, OLDPL) 
UPDATE(F, *=$$$$, L=A1247) 
6/7/8/9 


HY 

HD 


The DEFINE options in the verification job coincide with the 
method under which APT was installed (i.e., STANDARD, 
SYSTEM, USERLIB, PERMFILE). Choose only one of 
these options when running the verification job. 


To run the verification job, assuming APT was installed on 
permanent files, execute the following procedure: 

f MT1. ) 

PERMAMP, Em j 

ACCOUNT. 

LABEL(PL59A, R, L=APT4V2, D= 

VSN=PL59A) 

SKIPF(PL59A,4,17) 

COPYBF(PL59A, OLDPL) 

UPDATE(Q, *=$$$$,D, 8) 

ROUTE(COMPILE,DC-IN) 

7/8/9 

$IDENT, SELECDK 

$DELETE, VERIFY. 8 (To change ACCOUNT 

ACCOUNT. cards as needed.) 

$DEFINE, PERMFILE 
$COMPILE, VERIFY 
6/7/8/9 



The verification job is a sample APT IV part program with 

To obtain a listing of the verification job, run the following neither parametric nor sculptured surfaces. The output 
procedure: from this job should be compared to file 6 of PL59A. File 

6 can be printed with a COPYSBF. 
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GPSS V/6000 1.2 


RELEASE DESCRIPTION 


GPS1, GPS2, or VGPS may be obtained from PL35 by 
executing a job of the following form: 


HARDWARE REQUIREMENTS 

A minimum field length of 100K octal is required to load 
GPSS V 1.2. Once loaded, it requires a minimum field 
length of 45K octal to execute. Other requirements are 
the same as the minimum hardware configuration for 
NOS/BE. 


RELEASE MATERIALS 


The release materials for GPSS V Version 1.2 are included 
on the release tape PL35. The release tape contains six 
files: 


I MT1 j 
HD1 1 . 

PEI ) 

ACCOUNT. (Supply valid ACCOUNT card.) 

j HY I 

LABEL(PL35,R,L=GPSSV1P2,VSN=PL35,D= < HD >) 

( PE ) 

UPDATE(Q, P=PL35, *= =, C=PUNCH) 

7/8/9 

=DEFINE X 

=/ UPDATE CARDS TO MODIFY INSTALL DECKS GO 
HERE. 

=C Y 
G/7/8/9 


File 1 - GPSS V installation job decks GPS1 and GPS2, 
also the verification job deck VGPS in UPDATE format. 
The master control character for this UPDATE file 
is an equal sign (=). 

File 2 - GPSS V preloaded absolute binaries. 

File 3 - GPSS V relocatable binaries. 

File 4 - GPSS V program library in UPDATE format. 

File 5 - sample GPSS V model which is used as input 
by the verification deck VGPS. 

File 6 - output from verification job VGPS. 


INSTALLATION PROCEDURES 


File 1 of PL35 contains the installation decks GPS1, GPS2, 
and the verification deck VGPS. 

GPS1 updates the GPSS V program library (file 4), reas¬ 
sembles GPSS V, and creates a new PL35 in the same 
format as the original release PL35. GPS1 may be used 
to configure the original release PL35 for a particular 
installation and also to install PSR corrective code. 

GPS2 installs the preloaded absolute binaries on a perma¬ 
nent file named GPSS,ID=CCT. GPSS V may be executed 
from this permanent file. The local file name for GPSS V 
must be GPSS. 

VGPS attaches the permanent file GPSS,ID=CCT and 
executes the model on file 5 of PL35. Output from VGPS 
should be similar to the output on file 6 of PL35. 


X = HY or HD or PE 
Y = the deck name 

HY selects 800 bpi 7-track tapes 
HD selects 800 cpi 9-track tapes 
PE selects 1600 cpi 9-track tapes 

If a card punch is not available or if the user desires to 
execute either GPS1, GPS2, or VGPS directly from PL35, 
the following three cards should be substituted for the 
UPDATE card in the previous deck: 

REQUEST (COMPILE, *Q) 

UPDATE(Q, P-PL35, *= =) 

ROUTE(COIMPILE, DC=IN) 

In order to list GPS1, GPS2, or VGPS as they appear on 
PL35, a job of the following form should be executed: 

( MT1 | 

HD1 > . 

PEI ) 

ACCOUNT. (Supply valid ACCOUNT card.) 

VSN (TAPE=PL35) [ HY ] 

LABEL(TAPE, R, L=GPSSV1P2, D= j HD 1 ) 

M 

UPDATE(Q, L= = A12347, *= =, P=TAPE) 

7/8/9 
~C GPS1 
=C GPS2 
=C VGPS 
6/7/8/9 
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INSTALLATION PARAMETERS 


Option 


Definition 


For maximum efficiency, several installation options are 
provided to configure GPSS V to individual installations. 

To select an option, an update *DEFINE option name card 
should be included in the configuration run. Options are: 

Option Definition 

CRM All I/O requests will be processed by 

the CYBER record manager. If not 
selected, standard CIO requests will 
be used. CYBER record manager will 
be used for I/O on the following files: 
INPUT, OUTPUT, JOBTA1, JOBTA2, 
and JOBTA3. All internal file opera¬ 
tions on files not available to the 
HELP block user still use CIO direct¬ 
ly for speed purposes. 

CP64 Code will be optimized for a 6400 type 

processor. If not selected, a 6600 
type processor is assumed. 

XJOP Monitor requests will be executed via 

the XJ instruction. If not selected, 
the XJ instruction is not used. 

IMUL Integer multiply hardware is installed. 

FILELOAD If defined, the preloader will create a 
random file containing the overlays. 
This version of GPSS cannot be placed 
on the system, but must be run from 
a permanent file. However, the field 
length required to start a GPSS run is 
reduced to what is needed to load the 
(0,0) overlay plus the longest primary 
overlay, which is about 30K instead 
of approximately 75 to 105K when 
FILELOAD is not defined. No ECS 
load options are available when 
FILELOAD is defined. 

REPRIEVE If defined, the error termination 
printout section is executed when 
GPSS execution is halted due to opera¬ 
tor drop, exceeding CP or I/O time 
limit, or exceeding mass storage 
r limit. Thus, the results of the simu¬ 

lation up to the point at which GPSS 
execution is halted for one of the above 
reasons is printed. If REPRIEVE is 
not defined, GPSS execution is halted 
without an error termination printout. 

FTRACE If defined, then in addition to the 

standard one-line trace of GPSS V/ 
6000, the current transaction is also 
listed. This option slows down a simu¬ 
lation which uses the TRACE feature 
by a factor of 2 to 10 depending upon 
the amount of tracing done. It also in¬ 
creases the minimum field length for 
all runs by 2 to 3 K. 


LISALL If defined, LIST and UNLIST cards are 

listed on the output file when en¬ 
countered. Otherwise, they are never 
listed. 

CMR, XJOP, IMUL, and REPRIEVE are included by 
default in the install deck GPS1. 

Other parameters that may be changed for an installation 
are the operating system name and installation name. 

Cards of the following type may be used as input to 
update to change these parameters: 


*D, GPSSTXT. 419. GPSSTXT. 420 
OPSYSTEM MICRO l,,$NOS/BE 1 ,X$ 
INSTALL MICRO 1,, ^installation name$ 


CONFIGURATION RUN 

A job of the following form may be run to generate a new 
PL35 tape which is configured for a particular installation. 

I MT1 | 

HD1 > . 

PEI j 

ACCOUNT. (Supply valid ACCOUNT card.) 

REQUEST (COMPILE, *Q) 

VSN (TAPE=PL35) [HY] 

LABEL(TAPE, R, L=GPSSV1P2, D= |hd| ) 

M 

UPDATE(Q, *= =, P=TAPE) 

ROUTE (COM PILE, DC=IN) 

7/8/9 

^DEFINE X 
=D,GPS1. 8 

=/ USER (Supply valid USER card.) 

=I,GPS1. 54 

*D,GPSSTXT. 419,GPSSTXT. 420 
OPSYSTEM MICRO 1,, $NOS/BE l.X$ 

INSTALL MICRO 1,, Sinstallation name$ 

=C,GPS1 

6/7/8/9 


where: 

X = HY or HD or PE 


PSR MODIFICATION RUN 

A job of the following form may be run to update GPSS V 
with PSR corrective code and generate a new PL35. The 
PSRs should be placed on a permanent file called USER, 
ID=CCT previous to this run. 
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PSR, CM45000,T100, 


where: 


MT1 


HD1 

PEI 


ACCOUNT. (Supply valid ACCOUNT card.) 

REQUEST(COMPILE, *Q) 

VSN (TAPE=PL35) HY J 

LABEL (TAPE, R, L=GPSSV1P2, D= HD 1 ) 

PEj 


UPDATE (Q, *= =, P=TAPE) 
ROUTE (COMPILE, DC=TN) 

7/8/9 

=DEFINE X 
=D GPS1. 8 

=/ ACCOUNT CARD GOES HERE. 
=I,GPS1.15 

ATTACH(PSRS, USER, ID=CCT) 
=D, GPS1. 48,GPS1. 55 
*READ PSRS 
=C, GPS1 
G/7/8/9 


X = HY or HD or PE 


NOTES AND CAUTIONS 

The deck GPSSTXT on the source OLDPL (file 4) of PL35 
contains documentation which is an overview of the system. 
It is not required but may be helpful for the user to obtain 
a listing of GPSSTXT by assembling it using COMPASS. 

When loading GPSS V, five nonfatal errors are noted. 

These errors are of the form: 

DUPLICATE ENTRY POINT NAME - INIT 

Errors of any other form should be investigated. 
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IMSL 6 
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RELEASE DESCRIPTION 


Step 1. Generate Essential Listings 


This step includes: 

IMSL 6 (International Mathematical and Statistical Library, 

Version 6) consists of more than 400 FORTRAN functions • Installation deck, 

and subprograms. IMSL 6 is on PL87. 

• Verification deck, and 


HARDWARE REQUIREMENTS 


• Expected verify output. 


IMSL 6 requires the minimum hardware configuration for 
NOS/BE. 


NOTES AND CAUTIONS 

The installation process does not provide program listings. 
If a program listing is needed (it is very long), the FTN 
card in the install deck may be appropriately modified 
(remove L=0). 


RELEASE MATERIALS 


IMSL 6 resides on the tape known as PL87. PL87 is a 
program library in UPDATE format. It has the following 
characteristics: 7-track (800 bpi) or 9-track (800 or 1600 
cpi), binary recording mode, seven files: 


File 1 - install deck in UPDATE OLDPL format, 


NOTE 


The user must supply appropriate 
job and accounting cards. 


( MT1 
HD1 
PEI 
ACCOUNT. 


JOB, 


REQUEST (TAPE, 


(Supply appropriate accounting 
data.) 

HY \ 

HD \ ,VSN=IMSLIB, E) 
PE ) 



REWIND(TAPE) 

UPDATE(P^TAPE, F, D, 8,I=DUMMY, *=/,L=7) 


REWIND(TAPE) 
SKIPF(TAPE, 4,17) 


UPDATE(P~TAPE, F, D, 8, *=/, L- 7, R, I-DUMMY) 


REWIND(TAPE) 
SKIPF(TAPE, 5,17) 
COPYBF(TAPE, OUTPUT, 1) 
6/7/8/9 


File 2 - empty file, 


Step 2. Install IMSL 


File 3 - empty file, 

File 4 - program deck in UPDATE OLDPL format. 

File 5 - verify job control language deck in UPDATE 
OLDPL format, 

File 6 - expected verify output ((COPYBF,OUTPUT) 
format), and 

File 7 - verify program deck in UPDATE OLDPL 
format. 


INSTALLATION PROCEDURES 

The procedures for the installation of IMSL 6 are outlined 
in the following four steps. 


Installation characteristics are: 


• Permanent file name = IMS LIB, and 


• Public access rights (ID=PUBLIC). 


{ MT1 \ 
HD1 \ 
PEI J 
ACCOUNT. 


REQUEST(TAPE, 


(Supply appropriate accounting 
data.) 

HY \ 

HD 1 ,VSN=IMSLIB,E) 
PE j 


MT ) 
NT J ’ 


REQUEST (COMPILE, *Q) 
UPDATE(P=TAPE, F, D, 8, *=/) 


ROUTE (COMPILE, DC =IN) 

7/8/9 

/IDENT IMSL (Optional.) 

/DEFINE NOS BE (Required.) 
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Note that one of the following three tape parameters is 
required. 

/DEFINE MT (7-track, 800 bpi.) 

/DEFINE NT (9-track, 800 cpi.) 

/DEFINE NTPE (9-track, 1600 cpi.) 

/DELETE IMSLIL.XX (Required.) 

{ MT1 | 

HD1 1 , T1200. (Supply appropriate job 
PEI J and account information.) 

ACCOUNT. 

6/7/8/9 

Step 3. Run Verification Tests 


Refer to the following: 

( MT1 ) 

JOB, | HD1 i . 

I PEI j 

ACCOUNT. (Supply appropriate accounting 

data.) 

I MT | f MT1 ) 

REQUEST(TAPE, , { HD1 J , VSN=IMSLIB, E) 

’ NI ' l PEIj 


SKIPF(TAPE,4,17) 
REQUEST(COMPILE, *Q) 
UPDATE(P=TAPE, F, D, 8, *=/,R=C) 
ROUTE (COMPILE, DC=IN) 

7/8/9 

/IDENT IMSL (Optional.) 

/DEFINE NOSBE (Required.) 


One of the following three tape parameters (required). 


/DEFINE MT 
/DEFINE NT 
/DEFINE NTPE 

/DELETE IMSLVL. XX 
( MT1 ] 

JOB, | HD1 J , T300 
l PEI j 
ACCOUNT. 

6/7/8/9 

Step 4. Verification 


(7-track, 800 bpi.) 
(9-track, 800 bpi.) 
(9-track, 1600 bpi.) 

(Required.) 

(*,*,*,*) accounting data. 
(Supply appropriate job and 
account information.) 


Do a minimal visual comparison of the expected verify 
output and the actual verify output. 
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LCGT/IGS 2 
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RELEASE DESCRIPTION 

LCGT/IGS V2 (Low Cost Graphics Terminal Interactive 
Graphics System Version 2) runs under NOS/BE and 
INTERCOM to provide both a remote interactive graphic 
capability mode and timesharing capability in command 
mode. 

The LCGT/IGS subroutines are callable from user appli¬ 
cation programs only under FORTRAN Extended, and pro¬ 
vide the user with the capability of interacting with his 
program from the console using the keyboard and 
cross-hair. 

The operation of LCGT/IGS V2 requires the installation of 
INTERCOM and all other associated products with it under 
NOS/BE. 

HARDWARE CONFIGURATION 

The minimum hardware configuration required by NOS/BE 
and INTERCOM are required to support the LCGT 
terminal. 

Under INTERCOM, the station address for the LCGT 
terminal operating in synchronous mode must have an odd 
number address, such as 161. The station number is ir¬ 
relevant for the terminal operating in asynchronous mode 
(TTY compatible). 

HARDWARE OPTIONS 

A CDC synchronous interface (Tektronix product number 
021-0135-01) is required on each terminal to communi¬ 
cate with the 6671 multiplexer or the 255X host communi¬ 
cations processors in synchronous mode. 

RELEASE MATERIALS 

LCGT/IGS V2 release consists of a single magnetic tape, 
PL67, containing six files of data as follows: 

File 1 - installation job program library in UPDATE 
format, 

File 2 - empty, 

File 3 - empty, 

File 4 - program library of LCGT/IGS in UPDATE 
format, 

File 5 - verification job program library in UPDATE 
format, and 

File 6 - empty. 


NOTES AND CAUTIONS 

All limitations applicable to NOS/BE and INTERCOM also 
apply to LCGT/IGS V2. 

All subroutines in LCGT/IGS V2 are callable from user ap¬ 
plication programs in FORTRAN Extended only. 

The following terminal communications between LCGT and 
the central site are supported according to the interface 
modem. 


Mode 

Modem 

Baud Rate 

Synchronous 

201A 

2000 


201B 

2400 

Synchronous 

208B 

4800 

Asynchronous 

103A 

110 or 

300 


INSTALLATION PROCEDURES 

The installation of LCGT/IGS V2 requires creation of a 
user library, LCGTVR2, and a graphics class PP routine, 
GCC. Graphics activity should be stopped during the in¬ 
stallation. The job required to install LCGT/IGS is re¬ 
leased as an ihstallation deck. INTERCOM is required 
before attempting to utilize LCGT/IGS V2 but is not neces¬ 
sary for its installation. 

The installation job is file 1 on the release tape. This job 
is a program library in UPDATE format with = (equals) as 
the master character. A dummy ACCOUNT card is a part 
of this job. The user should first perform an UPDATE 
run and list the COMPILE file. As a part of the EXTRACT 
procedure, the user should modify the JOB/ACCOUNT 
cards appropriately for his installation. 

To obtain the installation job, execute a procedure of the 
form shown below: 

( MT1 \ 

EXTRACT,T10,CM60000, j HD1 1. 

I PEI J 

ACCOUNT. 

LABEL(LCGT, R, L=LCGTIGSV2, 

( HY J 

D= J HD > , VSN=LCGTV2) 

l PE ) 

COP YBF<LCGT, OLDPL) 

REQUEST (COMPILE, *Q) 

UPDATE(F, *= = , C, D, 8) 

UNLOAD(LCGT) 

ROUTE (COMPILE, DC=IN) 

7/8/9 
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=IDENT,XXX 
=DE FINE, NOS BE 

( MT ) 
NT > 
NTPE j 
=D, LCGTl,yyy 
ACCOUNT. 
=COMPILE, LCGT1 
G/7/8/9 


(7-track, 800 bpi.) 

(9-track, 800 bpi.) 

(9-track, 1600 bpi.) 

(To change job and ACCOUNT 
cards as needed.) 


File 5 is the verification job. This job is also in UPDATE 
format and may require changes in the JOB/ACCOUNT 
cards of the deck. A preliminary UPDATE run should be 
made and this deck listed for inspection. 

To catalog the binary of the verification job, the following 
XTRACT procedure can be used: 


{ MT1 ) 

HD1 1 . 

PEI ) 

ACCOUNT. (Supply valid ACCOUNT card.) 

LABEL(LCGT,R, L=LCGTIGSV2, 

I HY ) 

D={ HD \ ,VSN=LCGTV2) 

l PE ) 

SKIPF(LCGT, 4,17) 

COPYBF(LCGT, OLDPL) 

REQUEST(COMPILE, *Q) 

UPDATE(F, *==,C,D, 8) 

ROUTE (COMPILE, DC=IN) 

7/8/9 

=IDENT,XX 
=DEFINE, NOSBE 

=D,LCGT2.yyy (To change JOB and ACCOUNT 

ACCOUNT. cards as needed.) 

COMPILE, LCGT2 
6/7/8/9 


VERIFICATION PROCEDURE 


The verification program, VRFY, is created as a perma¬ 
nent file as described earlier. This program can be run 
to verify the proper installation of LCGT/IGS as follows: 

1. Follow the ’’Terminal Operating Procedures” to 
properly set up the terminal. 

2. Login with valid username and password. 

3. ATTACH (LCGTVR2, ID=LCGT, MR=1) 

4. ATTACH(VR FY,ID=LCGT, MR=1) 

5. LIBRARY (LCGTVR2) 

6. VRFY. 

7. You will be asked to enter terminal type (see 
figure II-6-1): 


l.= 4010 synchronous, 

2 = 4010 asynchronous, 

3 = 4014 synchronous, 

4 = 4014 asynchronous, 

5 =4014 with EGM, synchronous, and 

6 = 4014 with EGM, asynchronous. 

8. The screen will be cleared and figure II—6—2 will 
be displayed on the screen. 

9. Type in any number in the range 5 through 25 
followed by a (?R) . 

10. Figure II—6—3 resulted by typing in 13. 

11. Log out when finished. 


TERMINAL OPERATING PROCEDURES 


SYNCHRONOUS INTERFACE 

With CDC synchronous interface (see ’’Hardware Option”), 
LCGT can properly communicate with the following ports 
under INTERCOM: 

• ASCII, synchronous mode at 4800 baud rate. 

• ASCII, synchronous mode at 2000-baud rate 
(6671 only). 

• ASCII, asynchronous mode at 110-baud rate. 

• ASCII, asynchronous mode at 300-baud rate. 

To operate the terminal: 

1. Turn the terminal power on by pressing POWER 
switch to ON position (POWER lamp comes on red). 

2. Set ASCII/BCD switch to the ASCII position. 

3. Set the baud rate switch to one of the three fol¬ 
lowing positions: 

• EXT position if synchronous 2000-baud rate. 

• 300 position if asynchronous at 300-baud rate. 

• PROG position if asynchronous at 110-baud 
rate. 

4. Set CODE EXPANDER switch as follows: 

• Synchronous mode: turn the switch ON. 

• Asynchronous mode: turn the switch OFF. 

5. Following keyboard operation establishes proper 
operating mode: 

• Synchronous mode: press RESET key. 

ALPHA cursor should appear at upper left- 
hand corner of the screen. The terminal is 
ready for dialing up. 
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• Asynchronous mode: first press the RESET 
key, and then press the SHIFT, CTRL and 
P keys simultaneously. The terminal is 
ready for asynchronous mode. 

6. If the terminal is in synchronous mode, ON¬ 
LINE indicator lamp starts blinking when the 
proper communication is established. The indi¬ 
cator will not operate in asynchronous mode. 

INTERCOM will send the banner page and LOGIN message 
when it is ready for interactive command processing. 


STANDARD INTERFACE 

With standard interface, and without the special CDC 
Synchronous interface, the terminal can only be operated 
in asynchronous mode. 

The Asynchronous mode operating procedures are the same 
as the one described above, (except for step 5). The 
terminal is always in asynchronous mode, and, therefore, 
no special keyboard operations are required to establish 
the mode switching. 


i ENTER TERMINAL TYPE, 1 THRU 6 


Figure II—6—1. The User Is Asked to Enter Terminal Type 
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£NTTS? Kl^SCatS-ZS ) 
rrrt if* 1 fuTZGEZ 


ACCEPT 

PAPMlZT£f\( ? ) I 


Figure II-6-2. Terminal User Is Asked to Select Number 



Figure II-6-3. Result of Typing in a 13 
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RELEASE DESCRIPTION 


HARDWARE CONFIGURATION 

PERT/TIME requires a minimum hardware configuration 
with at least 65K (octal) central memory, three tape units, 
and the other minimum equipment required by NOS/BE. 


RELEASE MATERIALS 

PERT/TIME is on release tape PL85. PL85 contains 
PERT2P0 as file ID in HDR1 and six files: 

File 1 - installation deck program library in UPDATE 
format, 

File 2 - PERT/TIME in absolute binary format, 

File 3 - PERT/TIME in relocatable binary format, 
File 4 - source PL in UPDATE format, 

File 5 - empty, and 
File 6 - empty. 

LIMITATIONS 

Because the file names TAPE1 through TAPE7 are used 
internally, no user file name may be TAPE 1 through 7. 


INSTALLATION PROCEDURES 


The following job installs PERT/TIME executable binary 
on a permanent file: 


{ MT1 | 

HD1 J 
PEI ) 

ACCOUNT information 
VSN(TAPE=PL85) [ HY \ 

LABEL(TAPE, R, L=PERT2P0, { HD l ) 

l PE ) 

REQUEST(PERT78, *PF) 

SKIPF(TAPE, 1,17) 

COPYBF(TAPE, PERT78) 
CATALOG(PERT78,ID=PERT78) 

6/7/8/9 


To execute from the release tape PL85, run a job similar 
to the following: 


PERT, T1000, 


MT1 j 
HD1 \ 
PEI ) 


ACCOUNT information 


VSN(TAPE=PL85) 
LABEL(TAPE,R, L=PERT2P0, 


SKIPF(TAPE, 1,17) 
COPYBF(TAPE, PERT78) 
PERT78. 

7/8/9 | 

I PERT networks 
G/7/8/9 J 


HY 
HD 
PE , 


If a master data tape is made, insert the following after 
the LABEL statement: 


Release tape PL85 contains PERT/TIME. To get a listing 
and a punched-card copy of the installation decks from the 
first file of PL85, run a job similar to the following (if a 
card punch is not on-line, the decks must be keypunched 
by hand): 

{ MT1 \ 

IIDl 1 
PEI j 

ACCOUNT information 
VSN(TAPE-PL85) [ HY | 

LABEL(TAPE,R,L=PERT2P0,D= j HD | ) 

l PE J 

UPDATE(F, L=A12347, P=TAPE) 

REWIND(COMPILE) 

COP YBF(COMPILE, PUNCH) 

7/8/9 
6/7/8/9 


REQUEST TAPE6, MT. 

If an old master data tape is input and a new master data 
tape saved, insert the following after the LABEL statement. 

REQUEST TAPE4,MT. OLD MASTER 
REQUEST TAPE6, MT. NEW MASTER 

If either option is used the MT1 job card parameter must 
be increased. An entry must be placed on the Y-card for 
each additional tape used. 

Successive PERT/TIME networks may be processed by 
batching as follows: (A higher FL will be required.) 


r- 

L 
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K 

L 

M 

X 

Y 

W 

A PERT BATCHED NETWORKS 

• 

• 

A 

Z 

K 

L 

• 

Z 

(Input for each network starts with the K control card and 
ends with the Z control card.) 


The following job compiles and installs PERT/TIME from 
the source PL to a permanent file. 

{ MT1 j 
HD1 > . 

PEI j 

ACCOUNT information 
VSN(TAPE=PL85) [ HY ] 

LABEL(TAPE,L=PERT2P0, j HD > ) 

l PE ) 

SKIPF(TAPE, 3,17) 

UPDATE(F, P=TAPE,R) 

UNLOAD(TAPE) 

REWIND(COMPILE) 

REQUEST(PERT78, *PF) 

FTN (I=C OMPILE, B=P ERT, L=0) 

LOAD(PERT) 

NOGO(PERT78) 

CATALOG (PERT78, ID= : PERT78) 

7/8/9 
6/7/8/9 
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PRODUCT DESCRIPTION 777/IGS 
(HOST AND REMOTE), VERSION 2.2 

777/IGS (HOST and REMOTE), Version 2.2, in conjunction 
with INTERCOM 4 and the NOS/BE operating system, pro¬ 
vides a remote interactive graphics capability with time- 
shared access to Control Data CYBER 170L, CDC CYBER 
70L, and 6000 series computers from the 777 CYBER 
graphics terminal. Remote batch jobs may be submitted 
from 777 terminals equipped with a remote card reader 
and line printer. 

The 777/IGS host library provides the interface between 
the user’s application program written in FORTRAN Ex¬ 
tended and the operator of the 777 console. The console 
operator interacts with the application through the key¬ 
board, function keys, and light pen. 

The 777/IGS controller software allows the console opera¬ 
tor all INTERCOM commands and capabilities available to 
nongraphic CRT terminals and the use of remote batch 
capabilities as provided by 1700 IMPORT and controlled 
by the TTY. If the controller software is defined as voice 
grade communication, remote batch capabilities are 
compatible to a 200 UT via the 777 console. 


PRODUCT DESCRIPTION - 777/IGS WITH 3D 
(HOST AND REMOTE), VERSION 2.2 

777/IGS with 3D (HOST and REMOTE), Version 2.2, is a 
logical extension of 777/IGS (HOST and REMOTE), Version 
2.2. 777/IGS with 3D provides the capabilities of 777/IGS 
and a three-dimensional (3D) graphics capability. 

Prior to Version 2.2, the 777/IGS 3D products consisted 
of 3D routines added to the 777/IGS routines during instal¬ 
lation to form a graphics system with 3D capability. Be¬ 
ginning with Version 2.2, 777/IGS with 3D contains all the 
routines of a complete graphics system with 3D capability. 
This change in release format allows a simpler installation 
procedure using two release tapes rather than four. 


777/IGS (HOST) 

RELEASE DESCRIPTION 

777/IGS (HOST) runs under the NOS/BE operating system. 
Accordingly, it requires the same minimum hardware 
configuration as NOS/BE. 777/IGS (HOST) is designed to 
be used from permanent files. 


Release Materials 

777/IGS (HOST) resides on the tape known as PL40. This 
release tape contains six files: 

File 1 - program library of installation job. 

File 2 - program library of demo programs, 

File 3 - program library of the CDC CYBER graphics 
terminal performance program (CGTPP), 

File 4 - program library of 777/IGS (HOST), 

File 5 - empty, and 

File 6 - empty. 

The CGTPP is provided by the Systems Division of Vought 
Corporation and is included with these release materials 
at the request of VIM, Inc. 

Notes and Cautions 

The installation of 777/IGS requires installing from PL40 
(HOST) and PL41 (REMOTE). The installation jobs are on 
the first file of the tapes. The installation of INTERCOM 
4 is required before attempting to use 777/IGS but is not 
necessary for proper installation. 777/IGS runs on a 
Control Data CYBER graphics terminal, model 777-1, 
777-2, or 777-3. Graphics activity should be stopped 
during installation of new 777/IGS host software. 


INSTALLATION PROCEDURE 

File 1 on PL40 contains the deck INSTALL which is used 
to install the host software system (777/IGS library, debug 
library, and PP program GCC), the binaries for the demo 
programs, and the CGTPP. 

The user performs an UPDATE run to list the install job 
deck and locate the ACCOUNT and JOB cards in the deck. 
As part of the EXTRACT procedure, the ACCOUNT and/or 
JOB cards should be modified appropriately for the user’s 
installation. To list the contents of the install job deck, 
run the following job: 

{ MT1 | 

HD1 > . 

PEI I 
ACCOUNT. 

I HV \ 

LABEL,OLDPL,R, L=777IGSH,D= j HD > ,VSN=PL40. 

UPDATE, F, *=+, L=A7. 

UNLOAD,OLDPL. 

7/8/9 

6/7/8/9 
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Braces,{ }, in this section, indicate alternate parameters 
for installation from 7-track release tapes (top alternate) 
or from 9-track release tapes (bottom two alternates). 

Execution of the following procedure will install the host 
software: 

( MT1 | 

HD1 >. 

PEI J 

ACCOUNT. 

( HY I 

LABEL, OLDPL,R,L=777IGSH,D= l HD \ ,VSN=PL40. 

I PE ) 

REOUEST, COMPILE, *Q. 

UPDATE, F,*=+,D, 8. 

ROUTE, COMPILE, DC=IN. 

7/8/9 

+IDENT BUILD 

{ 7-TRACK ] l 7 TRACK, 800 bpi \ 

9-TRACK \ | 9 TRACK, 800 cpi \ 

9-TRPE j l 9 TRACK, 1600 cpi ) 

+DEFINE parameters as described below 
+DELETE INSTALL. 6 

ACCOUNT. J To change ACCOUNT and/ 

other modifications j or JOB cards as necessary. 
6/7/8/9 

The second +DEFINE card defines parameters by which 
optional functions of the install job are requested. These 
parameters are as follows: 

Parameter Definition 

IGSDBUG The 777/IGS debug library is cata¬ 

loged (IGSDBUG, ID=7 77). 

CATDEMOS Demo program relocatable binary 

files are cataloged (DEMOl, ID=777 
through DEM04,ID=777). 

VOUGHT Vought Corporation's Control Data 

CYBER graphics terminal perfor¬ 
mance program absolute binary file 
is cataloged (CGTPP,ID=777). 

EDITLIBPP The 777/IGS PP program GCC is in¬ 
stalled via a system EDITLIB. 
EDITLIBPP must be defined for cor¬ 
rect and complete installation of 
777/IGS (HOST) unless there have 
been no modifications to GCC since 
the last time a version of 777/IGS 
was installed. 

Regardless of the defined option parameters, the 777/IGS 
library will be cataloged (IGS777,ID=777). 


777/IGS (REMOTE) 

RELEASE DESCRIPTION 

The 777 controller software allows a console operator the 
use of all INTERCOM commands and capabilities to non¬ 
graphic CRT terminals. Use of remote batch capabilities 
as provided by 1700 IMPORT and controlled by the TTY 
are also available. If the controller software is defined 
as voice grade, remote batch capabilities are compatible 
to a 200 UT via the 777 console. 


Release Materials 

777/IGS (REMOTE) resides on the tape known as PL41. 

This release tape contains six files: 

File 1 - program library of installation job, 

File 2 - absolute binary of 8-bit intermediate bootstrap 
(405/430 card reader bootstrap), 

File 3 - absolute binaries of installation utility 
programs 

record 1: assembler, and 
record 2: binary generation routine; 

File 4 - program library of 777/IGS (REMOTE), 

File 5 - empty, and 

File 6 - empty. 

Notes and Cautions 

The installation of 777/IGS requires installing from PL40 
(HOST) and PL41 (REMOTE). The installation jobs are 
on the first file of the tapes. The installation of INTERCOM 
4 is required before attempting to use 777/IGS but is not 
necessary for proper installation. 

777/IGS runs on a Control Data CYBER graphics terminal, 
model 777-1, 777-2, or 777-3, 

A 415 card punch is needed to install 777/IGS REMOTE 
software. 

At sites with a 1729-3 card reader, do not mark the backs 
of any cards. This type of reflective reader may interpret 
the marks as punched holes. 

There is a configuration change (for MSOS 4 compatibility) 
with Version 2.1 of 777/IGS and an addition of several new 
peripheral options with Version 2.2. Users currently on 
777/lGS Version 2.0 will have to change the controller 
interrupts before going to a later system. The changes 
and additions are shown in Tables 11-8-1 and II-8-3. See 
also the 1743-1 Reference Manual. 
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TABLE II—8—1. INTERRUPT/EQUIPMENT HISTORY 

V2.0 V2.1 V2.2 


HW Error Processor 

0/- 

0/- 

0/- 

TTY 

1/1 

1/1 

1/1 

Zeta Plotter 

- 

- 

2/2 

Line Printer 

Voice Grade 

5/15 

4/4 

4/4 

C ommunications 

- 

5/5 

5/5 

405 CR 

6/6 

6/6 

6/6 

1732-3 Magnetic Tape 

- 

- 

7/7 

777 DCI Console 1 

10/4 

8/8 

8/8 

Wideband Communications 

3/5 

9/9 

9/9 

1743-2 (Hardcopy) 

- 

- 

10/10 

430 CR 

9/9 

11/11 

11/11 

777 DCI Console 2 

11/12 

12/12 

12/12 

777 DCI Console 3 

12/2 

14/14 

14/14 


TABLE II-8-2. FJ606 (1743) STRAPPING OPTIONS 

Sync Bits -►Bits 4, 2, and 1 (16.^) 

Parity Mode -►No Parity 

No Data Bits -^8 Bits 

Equip. Code -»-( 5 16) Bits 7 « 9 « 6 

Protect -►No Protect 

Int. Cycle Time-►No Plugs In 

Operating Mode-►Full Duplex, Both Data Sets 


LOCAL HARDCOPY 


HOST HARDCOPY 

A Houston Instrument plotter and associated controller can 
be directly attached to the 1742-X line printer. This re¬ 
quires the use of the Houston Instrument UNIPLOT 
post-processor. 


INSTALLATION PROCEDURE 

File 1 on PL41 contains the deck INSTALL. It builds and 
punches out the controller software deck (with appropriate 
intermediate bootstrap). 

First, the user performs an UPDATE run to list the install 
job deck and locate the ACCOUNT and JOB cards in the 
deck. As part of the EXTRACT procedure, the ACCOUNT 
and/or JOB cards should be modified appropriately for the 
user’s installation. To list the contents of the install job 
deck, run the following job: 

( MT1 | 

HD1 > . 

PEI ) 

ACCOUNT. 

| HY \ 

LABEL, OLDPL, R, L=777IGSR, D= | HD > ,VSN=PL41. 

I PE ) 

UPDATE, F, *=+, L=A7. 

UNLOAD, OLDPL. 

7/8/9 

G/7/8/9 


Local hardcopy hardware requirements are: 

1743-2: 

- Set on equipment 10 interrupt line 10. 

- Baud rate set at 300-9600 (same as Tektronix). 

- Half duplex. 

- 8 bits, ASCII data. 

- No parity. 

- Port 0. 

Tektronix 4010 (or equivalent): 

- Full duplex. 

- Baud rate set at 300-9600 (same as 1743-2). 


Braces, { J , used in this section, indicate alternate 
parameters for installation from 7-track release tapes 
(top alternate) or from 9-track release tapes (bottom two 
alternates). 

Execution of the following procedure will provide a card 
deck on the 415 card punch unit. This deck consists of 
an 8-bit special loader (intermediate bootstrap) followed 
by the controller software. There is one and only one 
8-bit format loader. It will execute correctly for the 
430, 1729-3 or 1726/405 card readers. This deck is used 
as input for the controller initialization procedure as de¬ 
scribed in the 777/IGS Remote Job Entry User Guide. 


Required cable modifications to run without modems on 
the 1743-2 and 4010 are as follows: 


1743 End (Pin) 


(Pin) Tektronix End 


TD 

(2) 

>- 

RD 

(3) 

>— 

RTS 

(4) 

>- 

CTS 

(5) 

>- 

DCD 

(8) 

>— 

DSR 

(6) 

>- 

DTR 

(20) 

>- 


(3) 

RD 

(2) 

TD 

(8) 

DCD 

(4) 

RTS 

(5) 

CTS 

(6) 

DSR 


! MT1 j 
HD1 > . 

PEI ) 

ACCOUNT. 

LABEL, OLDPL, R, L=777IGSR, D= 

REQUEST, COMPILE, *Q. 
UPDATE, F,*=+,D, 8. 

ROUTE, COMPILE, DC=IN, 

7/8/9 


HY 

HD 

PE 


, VSN=PL41. 
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+IDENT BUILD 

I 7-TRACK| 1 7 TRACK, 800 bpi j 

9-TRACK \ | 9 TRACK, 800 cpi \ 

9-TRPE ) (9 TRACK, 1600 cpi) 

+DEFINE parameters as described below 
+DELETE INSTALL. 6 \ To change ACCOUNT 
ACCOUNT. I and/or job cards 

other modifications j as necessary 

6/7/8/9 

The second +DEFINE card defines parameters by which 
optional functions of the install job are requested and 
certain characteristics of the controller software con¬ 
figuration are specified. These parameters are as shown 
in figure II—8—1. 


CONTROLLER INITIALIZATION PROCEDURE 

The operator loads the card deck produced by the 777/IGS 
(REMOTE) installation procedure into the 777 CYBER 

Parameter 


1 . 

May define 1 of: 

CONI, CON2, or 
CON3 

2. 

May define 1 of: 

24K, 28K, 32K, 36K 
40K, 44K, 48K, 52K 
56K, 60K, or 65K 

3. 

May define 1 of: 

CR405 or CR430 

4. 

May define 1 of: 

026 or 029 

5. 

May define: 

LP501 

6. 

May define: 

LP501 and LP1742 

7. 

May define 1 of: 

DMP421 or DMP42X 

8. 

May define 1 of: 

IMPORT or CM1743 


9. 

May define: 

TTY 

10. 

May define: 

UT 

11. 

May define: 

MT 

12. 

May define: 

PL 

13. 

May define: 

HC 


graphics terminal controller from the remote card reader 
to initialize the controller. For a detailed description of 
this process, please refer to the 777 IGS Remote Job Entry 
User Guide. 


VERIFICATION PROCEDURES— 777/IGS 
(HOST AND REMOTE) 

In order to verify that the 777/IGS system has been properly 
installed, the four demo programs may be executed. It is 
assumed that CATDEMOS was defined in the host EXTRACT 
job so that the demo program binaries have been cataloged 
as DEMOl,ID=777 through DEM04,ID=777. For general 
information on terminal operations, please refer to the 
777 IGS Reference Manual. 


Definition 

Configure 777 system with one, two, or three consoles, 
respectively. Default is CONI. 

Configure 777 system with controller memory size 
indicated. Default is 28K. 

Configure system with 1726/405 card reader or 1728/430 
card read-punch, respectively. (1729-2,3 card readers 
need CR430). Default is no card reader. 

Set keypunch code for all remote batch to 026 or 029, 
respectively. Default is 026. 

Configure 777 system with 1740/501 or 1742 line printer. 
Configure 777 system with 1742-30 line printer. 

Controller software will include a dump routine. It will 
output to a line printer configured into the system via 
defining LP501 or LP501 and LP1742, respectively. 

Default is no dump routine. 

Configure 777 system to use wideband or voice-grade 
communications, respectively, and to have batch pro¬ 
cessing capabilities. If neither IMPORT nor CM1743 is 
defined, the 777 system uses wideband communications 
and has no batch processing capabilities. (Wideband 
communication with the host computer uses high-speed 
INTERCOM.) 

Configure 777 system with a TTY. 

Configure 777 system with a utility processor as described 
in the 777 IGS Remote Job Entry User Guide. 

Configure 777 system with a 1732-3/616-92,95 9-track 
magnetic tape unit. 

Configure 777 system with a Zeta 1200-series plotter. 

Configure 777 system for Tektronix 4631 hardcopy 
capability via a Tektronix display and a 1743-2 communi¬ 
cations controller. 


Figure II—8—1. Second +DEFINE Card Parameters 
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The operator should log in and enter the following com¬ 
mands to INTERCOM: 

ATTACH, IGS777,ID=777,MR=1 
ATTACH, DEMOl, ID-777, MR=1 
ATTACH, DEM02,ID=777, MR = 1 
ATTACH, DEM03,ID=777,MR=1 
ATTACH,DEM04,ID=777, MR=1 
LIBRARY, IGS777 

At this point, entering DEMOl, DEM02, DEM03, DEM04 
will cause a demo program to be executed. Brief de¬ 
scriptions of the demo programs are as follows: 

DEMOl After the operator enters GO in response 
to a PAUSE, the so-called quick-look 
pattern graphics sampler appears on the 
console screen along with another PAUSE. 
When the operator again enters GO, the 
program terminates. 

DEM02 A display of numbers appears on the 
console screen along with a prompting 
message which requests that the operator 
choose a number with the lightpen. Then, 
a doily pattern appears. The complexity 
of the pattern depends directly on the 
magnitude of the selected number. At 
this point, the operator may select the 
ENCORE lightbutton returning the initial 
display for another choice or select the 
FIN lightbutton terminating the program. 

DEM03 A lightbutton menu of interactive functions 
appears on the screen. The operator uses 
this menu, together with the lightpen and 
keyboard, to interact with the graphics 
display file. The interactive functions are 
tracking, windowing, zooming, copying, 
moving, deletion, freehand, rubber-band 
drawing, and hardcopy. When the opera¬ 
tor enters GO, the program terminates. 

DEM04 180 simple pictures appear and disappear 
in quick succession followed by an eight- 
leafed rose pattern and a PAUSE. Press 
the INT key twice so that the pattern is 
on the screen, but the input rectangle is 
not. Then, space-bar presses start and 
stop an intriguing simulated film loop. 

To terminate, press the INT key to regain 
the input rectangle and then enter a GO. 


777/IGS WITH 3D (HOST) 

RELEASE DESCRIPTION 

777/IGS with 3D (HOST) runs under the NOS/BE operating 
system. Accordingly, it requires the same minimum hard¬ 
ware configuration as NOS/BE. 777/IGS with 3D (HOST) 
is designed to be used from permanent files. 


Release Materials 

777/IGS with 3D (HOST) resides on the tape known as 
PL46. This release tape contains six files: 

File 1 - program library of installation job, 

File 2 - program library of demo programs, 

File 3 - program library of the Control Data CYBER 
graphics terminal performance program (CGTPP), 

File 4 - program library of 777/iGS with 3D (HOST), 

File 5 - empty, and 

File 6 - empty. 

The CGTPP is provided by the Systems Division of Vought 
Corporation and is included with these release materials 
at the request of VIM, Inc. 

Notes and Cautions 

The installation of 777/IGS with 3D requires installing 
from PL46 (HOST) and PL47 (REMOTE). The installation 
jobs are on the first file of the tapes. The installation of 
INTERCOM 4 is required before attempting to use 777/IGS 
with 3D but is not necessary for proper installation. 

777/IGS with 3D runs on a Control Data CYBER graphics 
terminal, model 777-1, 777-2, or 777-3. 

Graphics activity should be stopped during installation of 
new 777/IGS HOST software. 


INSTALLATION PROCEDURE 

Installation of 777/IGS with 3D (HOST) from PL46 is 
exactly the same as the installation of 777/IGS (HOST) from 
PL40 with three exceptions. 

1. The LABEL control card in the LIST and 
EXTRACT jobs is as follows: 


LABEL, OLDPL, R, L=777IGSH3D, D= < HD > , 
VSN=PL46. (PE) 

2. An extra card should be entered into the EXTRACT 
job deck immediately after the IDENT card. The 
new extra card is as follows: 

+DEFINE (2D+3D) 

3. The CATDEMOS option in the EXTRACT job will 
catalog a fifth demo program (DEM05,ID=777) 
which may be used to verify correct installation 
of the 3D system. During execution of the pro¬ 
gram, selection of the word ROTATE with the 
lightpen causes a box-shaped 3D figure to rotate. 
Pressing any function key causes program termi¬ 
nation to occur. 
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777/lGS WITH 3D (REMOTE) 

RELEASE DESCRIPTION 

The 777 controller software allows a console operator the 
use of all INTERCOM commands and capabilities available 
to nongraphic CRT terminals. The use of remote batch 
capabilities as provided by 1700 IMPORT and controlled by 
the TTY are also available. If the controller software is 
defined as voice grade, remote batch capabilities are 
compatible to a 200 UT via the 777 console. 


Release Materials 

777/IGS with 3D (REMOTE) resides on the tape known as 
PL47. This release tape contains six files: 

File 1 - program library of installation job, 

File 2 - absolute binary of 8-bit intermediate 
bootstrap (405/430 card reader bootstrap), 

File 3 - absolute binaries of installation utility 
programs 

record 1: assembler, and 

record 2: binary generation program; 

File 4 - program library of 777/IGS with 3D 
(REMOTE), 

File 5 - empty, and 

File 6 - empty. 

Notes and Cautions 

The installation of 777/IGS with 3D requires installing 
from PL46 (HOST) and PL47 (REMOTE). The installation 


jobs are on the first file of the tapes. The installation of 
INTERCOM 4 is required before attempting to use 777/IGS 
with 3D but is not necessary for proper installation. 

777/IGS with 3D runs on a Control Data CYBER graphics 
terminal, model 777-1, 777-2, or 777-3. 

A 415 card punch is needed to install 777/IGS REMOTE 
software. 

At sites with a 1729-3 card reader, do not mark the backs 
of any cards. This type of reflective reader may interpret 
the marks as punched holes. 

The configuration change described in the notes and 
cautions under 777/IGS (REMOTE) also applies to 777/IGS 
with 3D (REMOTE). 


INSTALLATION PROCEDURE 

Installation of 777/IGS with 3D (REMOTE) from PL47 is 
exactly the same as the installation of 777/IGS (REMOTE) 
from PL41 with two exceptions. 

1. The LABEL control card in the LIST and 
EXTRACT jobs should be as follows: 


LABEL, OLDPL, R, L-777IGSR3D, D= < HD> , 
VSN=PL47. (PE) 

2. An extra card should be entered into the EXTRACT 
job deck immediately after the IDENT card. The 
new extra card should be as follows: 

+DEFINE (2D+3D) 
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RELEASE DESCRIPTION 


SIMSCRIPT I. 5 Version 3 operates under NOS/BE 1 on 
the same minimum configuration as NOS/BE. 

RELEASE MATERIALS 

The release materials for SIMSCRIPT I. 5 Version 3 are 
included on program library tape PL27. The release tape 
contains six files: 

File 1 - SIMSCRIPT installation job decks SIMI51 and 
SIMI52 plus verification job deck VSIMI5, 

File 2 - SIMI5 compiler (in EDITLIB binary format), 

File 3 - SIMI5 execution library, 

File 4 - program library containing compiler and 
execution library in UPDATE 1.2 format (a detailed 
description of the file appears below), 

File 5 - blank file, and 

File 6 - output from verification job VSIMI5. 

LIMITATIONS 

SIMSCRIPT 1.5 Version 3 operates under NOS/BE 1 in 
conjunction with COMPASS 3 and FORTRAN Extended 4. 


INSTALLATION PARAMETERS 


None. 


INSTALLATION PROCEDURES 


SIMSCRIPT Version 3 is made up of a compiler and an 
execution library. They are contained in a single UPDATE 
record to facilitate generation of an overlay tape. 

The first 73 decks (ADEF through ASML) belong to the 
SIMSCRIPT Version 3 compiler and are written in 
SIMSCRIPT. 

ADEF contains the definition deck necessary to com¬ 
pile the compiler. It always must be written on the 
COMPILE file when any compiler routine written in 
SIMSCRIPT is to be recompiled. 


MAIN AD through WASM (15 decks) represent the 
definition processor part of the compiler (overlay 1. 0). 

DEFINE through REFL (52 ddcks) represent the 
translator part of the compiler (overlay 2.0). 

ASMBL through ASML (5 decks) represent the as¬ 
sembler phase of the compiler (overlay 3.0). 

The TREND$ deck marks the end of the SIMSCRIPT 
language routines; it contains a *WEOR. 

The following 38 decks (SIMI5 through ALLOUT) belong 
to the SIMI5 compiler and are written in COMPASS. 

SIMI5 through XXERROR represent the root segment 
of the compiler (overlay 0.0). 

XX$DEFS through CONUM are part of the definition 
processor overlay (overlay 1.0). 

XX$TRAN through PACKIT are part of the translator 
overlay (overlay 2.0). 

XX$FAKE represents overlay 2.1. 

XXSASMB through ALLOUT are part of the assembler 
overlay (overlay 3.0). 

The UTEND$ deck marks the end of the compiler routines 
written in COMPASS; it contains a *WEOR. 

The 26 decks from XXSMAIN through XXSFMT represent 
the SIMI5 execution library and are written in COMPASS. 

Loader control cards are included in the following decks: 
SIMI5, XXSDEFS, XX$TRAN, XXSFAKE, and XX$ASMB. 

The SIMI5 compiler automatically generates the following 
LDSET table to reference the necessary libraries: 

SIMLIB which should contain the SIMI5 execution 
library 

FORTRAN 

BAMLIB 


SYSTEM GENERATION 

SIMSCRIPT installation job decks SIMI51 and SIMI52, plus 
verification job deck VSIMI5, may be obtained from the 
first file of PL27 by executing a job of the following 
form: 
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{ MT1/| 

HD1. 1 
PEI.) 

ACCOUNT CARD. (EY\ 

LABEL(PL27,R, L=SIMI53P0,D= l HD \ ,VSN-PL27) 

Ipe) 

UPDATE(Q, P-PL27, *==, C-PUNCH) 

7/8/9 

-DEFINE X 
=C Y 
6/7/8/9 


04.13. 36. VSIMS1H 

04.13.36. VSIMS, CM65000, T1000. 

04.13.36. THIS SIMPLE PROGRAM VERIFIES CORRECT 
04.13.36. INSTALLATION OF 
04.13.36. SIMSCRIPT 
04.13.36. SIMI5. 

04.13.42. LGO. 

04.13.47. STOP 

04.13.47.CP 004.403 SEC. 

04.13.47.PP 002.815 SEC. 


where X-HY, HD or PE and Y is the deck name. 

The SIMI51 deck includes the control cards necessary to 
generate the SIMSCRIPT Version 3 compiler and execution 
library from the release tape. It also generates a new 
program library tape. If PSRs are to be applied against 
SIMSCRIPT they should be placed on a permanent file 
called MINIT, ID=CCT previous to execution of SIMI51. 

Job SIMI52 can be used to enter SIMSCRIPT Version 3 into 
the running system through EDITLIB either from the re¬ 
lease PL27 or from the tape created by SIMI51. Job DST3 
may then be run to secure a deadstart tape including 
SIMSCRIPT Version 3. 


VERIFICATION PROGRAM 


The verification deck provided with the release validates 
SIMSCRIPT. The validation consists of a SIMSCRIPT job 
with a report. The time required to run the validation job 
is about one minute. The output includes the actual valida¬ 
tion (magic squares) and dayfile as follows: 

THIS IS A 3 BY 3 MAGIC SQUARE. ALL OF THE ROWS, 
COLUMNS AND DIAGONALS SUM TO 15: 

4 3 8 

9 5 1 

2 7 6 


HY selects 800 bpi 7-track tapes. 
HD selects 800 bpi 9-track tapes. 
PE selects 1600 bpi 9-track tapes 


If a card punch is not available, or if the user desires to 
execute either SIMI51, SIMI52, or VSIMI5 directly from 
PL27, a job of the following form should be executed. 


{ MT1| 
HD1 / . 
PEI) 

ACCOUNT CARD. 

LABEL(PL27,R, L-SIMI53P0,D= 

REQUEST(COMPILE, *Q) 
UPDATE(Q, P=PL27, *= =) 

R EWIND(COMPILE) 

ROUTE (COMPILE, DC-IN) 

7/8/9 

-DEFINE X 
=C Y 
6/7/8/9 



»VSN-PL27) 


where X=HY, HD or PE and Y-deck name. 


In order to list SIMI51, SIMI52, or VSIMI5 as they appear 
on PL27 a job of the following form should be executed. 


{ MTlj 
HD1 J 
PEI J 

ACCOUNT CARD. JHY] 

LABEL(PL27,R, L-SIMI53P0,D- HD J ,VSN-PL27) 

pe; 


THIS IS A 5 BY 5 MAGIC SQUARE. ALL OF THE ROWS, UPDATE(Q,L-A 12347) 

COLUMNS AND DIAGONALS SUM TO 65: 7/8/9 

=C SIMI51 


11 

10 

4 

23 

17 

=C SIMI52 

18 

12 

6 

5 

24 

=C VSIMI5 

25 

19 

13 

7 

1 

6/7/8/9 

2 

21 

20 

14 

8 


9 

3 

22 

16 

15 
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TIGS 1 OVERVIEW 
RELEASE DESCRIPTION 

TIGS 1 (Terminal Independent Graphics System Version 1) 
runs under NOS/BE and INTERCOM (Version 4 or Version 
5) to provide the user with both a remote interactive 
graphic capability in graphic mode and a timesharing 
capability in interactive mode. 

TIGS 1 consists of a preprocessor and a post processor. 
The preprocessor writes a neutral display file that is then 
traversed by the post processor to produce graphics 
output to a specific terminal. 

The TIGS subroutines are callable from user application 
programs that are written in FORTRAN Extended. 

The operation of TIGS 1 under NOS/BE requires the in¬ 
stallation of INTERCOM and all associated products. 


HARDWARE CONFIGURATION 

The minimum hardware configuration required by NOS/BE 
and INTERCOM is required to support TIGS 1. 

Under INTERCOM, the site address for a terminal oper¬ 
ating in synchronous mode must be 16Og for BCD and 161g 
for ASCII. The site address is irrelevant for the terminal 
operating in asynchronous mode. 


RELEASE MATERIALS 

The TIGS 1 release requires both the preprocessor mag¬ 
netic tape, PL86A, and an appropriate post processor 
tape. Refer to the individual post processor sections for 
installation, verification, and terminal operation of TIGS 

1 . 


TIGS 1 PREPROCESSOR 

The TIGS 1 preprocessor resides on the tape known as 
PL86A. PL86A has the following characteristics: 
7-track (800-bits per inch (bpi)) or 9-track (800 or 1600- 
characters per inch (cpi)), binary recording mode, 
TIGSPREV1 as the file ID in the HDR1 label, and six 
files: 

File 1 - empty. 

File 2 - empty. 

File 3 - empty. 

File 4 - TIGS 1 preprocessor source code program 
library in UPDATE format. 

File 5 - empty, and 
File 6 - empty. 


TEKTRONIX 401X POST PROCESSOR 
OPTION 


RELEASE MATERIALS 

The Tektronix 401X post processor runs under NOS when 
installed with the TIGS 1 preprocessor. 

The Tektronix 401X post processor resides on the tape 
known as PL86B. PL86B is a program library in 
UPDATE format and has the following characteristics: 
7-track (800 bpi) or 9-track (800 or 1600 cpi), binary 
recording mode, TIGSTEKV1 as file ID in HDR1 label, 
six files: 

File 1 - installation job program library in 
UPDATE format, 

File 2 - empty. 

File 3 - empty. 

File 4 - TIGS 1 Tektronix post processor source 
code program library in UPDATE format. 

File 5 - verification job in UPDATE PL format, 
and 

File 6 - empty. 

NOTES AND CAUTIONS 

All limitations applicable to NOS/BE and INTERCOM also 
apply to TIGS 1 with the Tektronix 401X post processor. 

All TIGS 1 subroutines are callable from application pro¬ 
grams that have been written in FORTRAN Extended. 

A CDC Synchronous interface (Tektronix product number 
021-0135-01) is required on each Tektronix terminal to 
communicate in synchronous mode with the 6671 multiplexer 
or the 255X host communications processors. 

Communications between the terminal and the central site 
are supported for TIGS 1 with the Tektronix 401X post 
processor according to table II-10-1. 

TABLE II-10-1. TIGS/TEKTRONIX COMMUNICATIONS 
CAPABILITIES 


Communications 

Baud 

Compatible 

Mode 

Rate 

Modem Type 

Synchronous 

4800 

20SB 


2400 

201B 


2000 

201A 

Asynchronous 

1200 

212 A 


300 

103 A 
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INSTALLATION DESCRIPTION 


The installation of TIGS 1 with the Tektronix 401X post 
processor allows the user the option of generating either 
a segment/overlay loader library, TIGSLIB, or both a 
segment /overlay loader library, TIGSLIB, and a basic 
(nonsegment/nonoverlay) loader library, TIGSSFL. 

The segment/overlay loader library, TIGSLIB, can be 
used in those situations where memory requirements of 
graphic applications exceed the available NOS/BE field 
length. The user can employ the segment/overlay loader 
library, TIGSLIB, in conjunction with the CYBER loader 
to segment or to overlay a graphic application and thereby 
reduce memory requirements. Note that the use of the 
segment/overlay loader library, TIGSLIB, without seg¬ 
mentation or overlays greatly increases an application 
program field length requirement. For example, the 
installation verification program VRFY requires 50350g 
field length using TIGSSFL and 54267 g field length using 
TIGSLIB without segmentation or overlays. The segment/ 
overlay loader library, TIGSLIB, must be used if an old 
neutral display file is to be accessed by the application 
program. 

The basic (nonsegment/nonoverlay) loader library, 
TIGSSFL, can be used for graphic applications with 
memory requirements that do not exceed the NOS/BE 
available field length. 

TIGSLIB is installed by default by the installation job. 

Both TIGSLIB and TIGSSFL are installed by the installation 
job by specifying =DEFINE, BASIC LDR as an UPDATE 
directive. 

The installation of TIGS 1 with the Tektronix 401X post¬ 
processor requires the installation of a PP routine into 
the running system. The PP routine, GCC-Change 
Program to Graphics Classification, gives the calling 
program graphics classification for the duration of pro¬ 
gram execution and returns the page width and length to 
the calling routine. GCC is installed into the running 
system by the TIGS installation job. All graphics activity 
should be stopped during the installation of TIGS. 

INSTALLATION PROCEDURE 

The procedure for installation of TIGS 1 with the Tektronix 
401X post processor is outlined in the following two steps. 

Step 1. 

The installation job is file 1 on the Tektronix 401X post 
processor release tape (PL86B). File 1 is a program 
library in UPDATE format with = (equals) as the master 
control character. 

A dummy ACCOUNT card has been included as part of the 
installation job. Perform an UPDATE run against file 1 
of PL86B and list the COMPILE file to obtain the sequence 
number which corresponds to the ACCOUNT card (and any 
other control cards) which must be modified for installa¬ 
tion. A listing of the COMPILE file may be obtained by 
executing the following procedure: 


(MT1| (7-track, 800 bpi.) 

LISTI, T10, CM65000, |HDl|. (9-track, 800 cpi.) 

iPElj (9-track, 1600 cpi.) 

ACCOUNT(*) (Supply appropriate accounting 

information.) 

LABEL(TIGSPL, R, L=TIGSTEKV1, 

I HY| (7-track, 800 bpi.) 

HD \ , VSN=PL86B) (9-track, 800 cpi.) 

PE | (9-track, 1600 cpi.) 

COPYBF(TIGSPL, OLDPL) 

UNLOAD(TIGSPL) 

UPDATE(F, U, *==, L=17) 

C OP YSB F(C OMPILE, OUTPUT) 

7/8/9 

=IDENT, INSTALL 
=DEFINE, NOSBE 

I HY | (7-track, 800 bpi.) 

HD > (9-track, 800 cpi.) 

PE ) (9-track, 1600 cpi.) 

=DEFINE, BASIC LDR (This is an optional UPDATE 

directive. If the user wishes 
to install both a segment/ 
overlay loader library 
(TIGSLIB) and a basic (non¬ 
segment/nonoverlay) loader 
library (TIGSSFL), then this 
DEFINE statement must be 
included. If this DEFINE 
statement is not included, 
then only the control cards 
required to install a segment/ 
overlay loader library will 
be listed.) 

6/7/8/9 
Step 2 

Perform a full UPDATE on file 1 of the Tektronix post 
processor release tape, (PL86B), modifying the instal¬ 
lation job program library with the appropriate account¬ 
ing information and DEFINE UPDATE directives required 
for installation. Route the resulting installation job to 
the NOS/BE input queue by executing the following procedure, 
NOTE: Only the Tektronix post processor release tape 
(PL86B) is required for the EXTRACT job, but both the 
Tektronix post processor release tape (PL86B) and the 
TIGS 1 preprocessor release tape (PL86A) are required 
for the installation job routed to the NOS/BE input queue. 

EXTRACT, T10, CM65000, 

{ MT1| (7-track, 800 bpi.) 

HD1 > . (9-track, 800 cpi.) 

PEIj (9-track, 1600 cpi.) 

ACCOUNTS) (Supply appropriate accounting 
information,) 

LABEL(TIGSPL, R, L=TIGSTEKV1, 

j HY \ (7-track, 800 bpi.) 

D=|HD ,VSN=PL86B) (9-track, 800 cpi.) 

' PE J (9-track, 1600 cpi.) 

COPYBF(TIGSPL, OLDPL) 

UNLOAD(TIGSPL) 

REQUEST(C OMPILE, *Q) 

UPDATE (F, *=, L=17, D, 8) 

R OUT E (COMPILE, DC =IN) 

7/8/9 | 


• n-10-2 
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=IDENT, INSTALL 
=DEFINE, NOSBE 

^DEFINE, HD } 

l PE ) 

^DEFINE, BASICLDR 


=D, TIGS1.9 
ACCOUNT( ) 


6/7/8/9 


(7-track, 800 bpi.) 

(9-track, 800 cpi.) 

(9-track, 1600 cpi.) 

(This is an optional UPDATE 
directive. If the user wishes 
to install both a segment/ 
overlay loader library 
(TIGSLIB) and a basic 
(nonsegment/nonoverlay) 
loader library (TIGSSFL), 
the =DEFINE, BASIC LDR 
directive must be included 
as part of the UPDATE. If 
the =DE FINE, BASIC LDR 
directive is not included as 
part of the UPDATE, then 
only a segment/overlay 
loader library (TIGSLIB) 
will be installed.) 

(The user must modify the 
installation job program 
library with appropriate 
accounting information. 

The dummy ACCOUNT card 
sequence number, 9, was 
obtained from the compile 
file listing resulting from 
step 1 of the "Installation 
Procedure.") 


VERIFICATION PROCEDURE 

Use the following steps for verification: 
Step 1 


The verification job is file 5 on the Tektronix post proc¬ 
essor release tape, (PL86B). File 5 is a program lib¬ 
rary in UPDATE format with - (equals) as the master 
control character. 

A dummy ACCOUNT card has been included as part of the 
verification job. Perform an UPDATE run against file 5 
of PL86B and list the COMPILE file to obtain the sequence 
number which corresponds to the USER card (and any 
other control cards) which must be modified for installa¬ 
tion. A listing of the compile file may be obtained by 
executing the following procedure: 


(MTU (7-track, 800 bpi.) 
LISTV, T10, CM65000, |hDi|. (9-track, 800 cpi.) 

iPElj (9-track, 1600 cpi.) 
ACCOUNT^) (Supply appropriate accounting 


information.) 

LABEL(TIGSPL, R, L=TIGSTEKV1, 

( HY (7-track, 

D= HD VSN=P L86B) (9-track, 

* PE (9-track, 

SKIPF(TIGSPL, 4,17) 

COPYBF(TIGSPL, OLDPL) 

UNLOAD (TIGSPL) 

UPDATE (F, U, *==, L=17) 

C OP YSB F(C OMPILE, O UTPUT) 

7/8/9 


800 bpi.) 
800 cpi.) 
1600 cpi.) 


=IDENT, VERIFY 
=DEFINE, NOSBE 
6/7/8/9 


Step 2 


Perform a full UPDATE on file 5 of PL86B modifying the 
verification job program library with the appropriate 
accounting information and DEFINE UPDATE directives 
required for installation. Route the resulting verification 
job to the NOS/BE input queue by executing a procedure 
of the following form: 


XTRACT, T10, CM65000, 

800 bpi.) 
800 cpi.) 
1600 cpi.) 
accounting 


800 bpi.) 
800 cpi.) 
1600 cpi.) 

SKIPF(TIGSPL, 4,17) 

COPYBF(TIGSPL, OLDPL) 

UNLOAD(TIGSPL) 

REQUEST (COMPILE, *Q) 

UPDATE(F, *= = , L=17, D, 8) 

ROUTE (COMPILE, DC-IN) 

7/8/9 


! MT1| (7-track, 

HD11 . (9-track, 

PEI j (9-track, 

ACCOUNTS) (Supply appropriate 

information.) 

LABEL(TIGSPL, R, L=TIGSTEKV1, 


D= 


HY] 

(7-track, 

HD? , VSN=PL86B) 

(9-track, 

PE) 

(9-track, 


UDENT, VERIFY 
^DEFINE, NOSBE 
-D, TIGS2.4 
ACCOUNT* ) 


6/7/8/9 


(The user must modify the veri¬ 
fication job program library with 
appropriate accounting informa¬ 
tion. The dummy ACCOUNT 
card sequence number, 4, was 
obtained from the compile file 
listing resulting from step 1 of 
the "Verfication Procedure".) 
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Step 3. 


Hun the verification program, catalogued as permanent file 
VRFY by the verification job, to verify the proper installa¬ 
tion of TIGS 1. The verification program may be run as 
follows: 

1. Refer to the "Terminal Operating Procedures" 
to properly set up the terminal. 

2. Log in to NOS/BE with a valid user name and 
password. 

3. Attach the segment/overlay loader library perma¬ 
nent file and declare TIGSLIB a library: 

ATTACH(TIGSLIB, ID=TEK) 
LIBRARY(TIGSLIB) 

4. Attach the verification program permanent file 
and execute the verification program: 

ATTACH(VRFY,ID=TIGS) 

VRFY. 

5. The terminal operator will be asked to enter the 
terminal type (figure II-10-1). Enter the number 
which corresponds to the terminal type in use. 

6. The terminal operator will be asked to enter the 
baud rate (figure II-10-1). Enter the baud rate 
in use. 

7. The terminal operator will be asked if the tablet is 
to be used (see figure II-10-1). Enter N. The 
tablet is not required for the verification program. 

8. The terminal operator will be asked if a hardcopy 
unit is available (see figure II-10-1). Enter N. 

The verification program does not require the 
availability of a hardcopy unit. 

9. The terminal screen will be cleared and figure 
II-10-2 will be displayed if terminal type 4, 5, 

6, or 7 was selected in step 5. Figure II-10-3 
will be displayed if terminal type 2 or 3 was 
selected. Figure II-10-4 will be displayed if 
terminal type 1 was selected. 

10. if terminal type 1 was selected in step 5, oper¬ 
ations 11 through 14 will be skipped. 

11* The operator is allowed to pick one of three 

buttons: WINDOW, RESTORE, or QUIT. The 
button is picked by moving the crosshairs over 
the text of the button and depressing an alpha 
key on the keyboard. 

12. If WINDOW is picked, the terminal operator will 
be asked to locate the lower-left and then the 
upper-right corner of a new window to display. 
This is done by moving the crosshairs to the 
appropriate corner and depressing the T key 
on the keyboard. When both corners have 
been located, the new window will be displayed. 


13. If RESTORE is picked, the original display will 
be displayed. 

14. If QUIT is picked, the verification program 
will terminate. 

15. If a basic (nonsegment/nonoverlay) loader 
library, TIGSSFL, was not installed, then go to 
operation 19. 

16. Attach the basic (nonsegment/nonoverlay) loader 
library permanent file and declare TIGSSFL a 
library: 

ATTACH (TIGSSFL, ID=TEK) 

LIBR AR Y (TIGSSFL) 

17. Execute the verification program: 

VRFY. 

18. Repeat operation 5 through 14 to verify the basic 
(nonsegment/nonoverlay) loader library, TIGSSFL. 

19. Purge any unnecessary files generated during the 
installation or verification of TIGS 1. 

20. Log off when finished. 


TERMINAL OPERATING PROCEDURES 


TEKTRONIX 4006 TERMINAL 

Tektronix 4006 terminal operating procedures are as 
follows: 

1. Turn the terminal power on by turning the POWER 
switch, located at the rear of the display unit, to 
the ON position. 

2. Allow the terminal to warm up. 

3. Depress the PAGE key to erase the screen and to 
position the cursor to home position (the upper 
left-hand corner of the screen). 

4. Select the appropriate transmit and receive baud 
rates using the baud rate switches located at the 
rear of the display unit. 

5. The setting of the FULL/HALF DUPLEX switch 
located at the rear of the display unit is NOS/BE 
installation dependent. 

6. Turn the modem power on and verify that the 
modem is connected to the terminal. 

7. Dial the appropriate telephone number. 


• n-io -4 
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ENTER TERMINAL TYPE 
1 4006 ASYNCHRONOUS 

3 4010 SYNCHRONOUS 

3 4010 ASYNCHRONOUS 

4 4014 SYNCHRONOUS 

5 4014 ASS NCHRONOUS 

S 4014 U"EGH SYNCHRONOUS 
7 4014 LU'EGN ASYNCHRONOUS 

3 

ENTER BAUD RATE - 300,1300.2000,2400.4800 

3 

IS TABLET GOING TO BE USED CY/N) 

N 

IS HARD COPY UNIT AUAILABLE (V/N) 

N 


Figure II-10-1. Terminal User is Asked to Enter Terminal Type, Baud Rate, if Tablet is to be Used, 

and if Hardcopy is Available 



Figure II-10-2. Figure Displayed on Terminal Types 4, 5, 6, or 7 
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8. INTERCOM Version 4 will respond with a LOGIN 
message when ready for interactive command pro¬ 
cessing. INTERCOM Version 5, however, requires 
the user to depress the RETURN key after the 
terminal is polled before it will respond with a 
LOGIN message. 

TEKTRONIX 4010/4014 TERMINALS WITH 
SYNCHRONOUS INTERFACE 

Tektronix 4010 and 4014 terminals (equipped with Control 
Data synchronous interface) synchronous/asynchronous 
operating procedures are as follows: 

1. Turn the terminal power on. 

• Tektronix 4010 terminal: The POWER switch 
is located beneath the keyboard at the top of 
the pedestal stand. The red POWER indicator, 
located at the top of the keyboard, will il¬ 
luminate when power has been applied to the 
terminal. 

• Tektronix 4014 terminal: The POWER switch 
is located at the front lower right-hand corner 
of the pedestal stand. The green POWER in¬ 
dicator, located on the upper left-hand corner 
of the keyboard, will illuminate when power 
has been applied to the terminal. 

2. Allow the terminal to warm up. 

3. Press the PAGE key to erase the screen and to 
position the cursor to home position (the upper 
left-hand corner of the screen). 

4. Set the ASCII/ALT switch to the ASCII position. 

5. Select the appropriate baud rate switch settings. 

The switch should select the EXT position if the 
terminal is to be used for synchronous communica¬ 
tions at 2000 and 4800 baud. Otherwise, the termi¬ 
nal baud rate switch setting will correspond to the 
baud rate in use, 

• Tektronix 4010 terminal: Select the appro¬ 
priate transmit and receive baud rates using 
the baud rate switches located at the rear of the 
pedestal stand. 

• Tektronix 4014 terminal: Select the appro¬ 
priate baud rate using the baud rate switch lo¬ 
cated at the rear of the pedestal stand. 

6. The setting of the FULL/HALF DUPLEX switch 
is NOS/BE installation dependent. 

7. Set the CODE EXPANDER switch to one of the fol¬ 
lowing positions: 

• Synchronous mode communications: Turn the 
switch ON. 

• Asynchronous mode communications: Turn 
the switch OFF. 


8. The following keyboard operations establish proper 
operating mode: 

• . Synchronous mode communications: Place the 

terminal in local mode. Press the SHIFT 
key. While the SHIFT key is pressed, press 
the RESET PAGE key. Place the terminal 
in line mode and repeat the keyboard 
procedure. 

• Asynchronous mode communications: Place 
the terminal in local mode. Press and keep 
depressed the SHIFT key. Press and keep 
depressed the CNTL key. While both the 
SHIFT and CNTL keys are pressed, press 
the P key. Place the terminal in line mode. 

9. Dial the appropriate telephone number. 

10. INTERCOM Version 4 will respond with a LOGIN 
message when ready for interactive command 
processing. INTERCOM Version 5, however, re¬ 
quires the user to press the RETURN key after 
the terminal is polled before it will respond with 
a LOGIN message. 

TEKTRONIX 4010/4014 TERMINALS WITHOUT 
SYNCHRONOUS INTERFACE 

If the Tektronix 4010 and 4014 terminals are not equipped 
with the Control Data synchronous interface option, then 
the terminal can be operated in asynchronous mode only. 

The Tektronix 4010 and 4014 terminals asynchronous mode 
operating procedures are essentially the same as for the 
synchronous mode operating procedures. However, step 
8 of the synchronous mode operating procedures can be 
omitted. No special keyboard operations are required to 
establish mode switching since the terminals will always 
be in asynchronous mode when not equipped with the 
Control Data synchronous interface option. 

SANDERS GRAPHIC 7 POST PROCESSOR 
OPTION 

RELEASE MATERIALS 

The Sanders Graphic 7 post processor runs under NOS/BE 
when installed with the TIGS 1 preprocessor. 

The Sanders Graphic 7 post processor resides on the tape 
known as PL86C. PL86C is a program library in UPDATE 
format and has the following characteristics: 7-track 
(800 bpi.) or 9-track (800 or 1600 cpi.), binary recording 
mode, TIGSANDV1 as file ID in HDR1 label, six files: 

File 1 - installation job program library in UPDATE 
format. 

File 2 - empty. 

File 3 - empty. 

File 4 - TIGS 1 Sanders Graphic 7 post processor 
source code program library in UPDATE 
format. 
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File 5 - verification job in UPDATE PL format, and 
File 6 - empty. 


calling routine. GCC is installed into the running system 
by the TIGS installation job. All graphics activity should 
be stopped during the installation of TIGS. 


NOTES AND CAUTIONS 

All limitations applicable to NOS/BE and INTERCOM 5 
also apply to TIGS 1 with the Sanders Graphic 7 post 
processor. 

All TIGS 1 subroutines are callable from application pro¬ 
grams that have been written in FORTRAN Extended. 

Communications between the terminal and the central 
site are supported for TIGS 1 with the Sanders Graphic 7 
post processor according to table II-10-2. 

TABLE II-10-2. TIGS/SANDERS COMMUNICATIONS 
CAPABILITIES 


C ommuni cation 

Baud 

Compatible 

Mode 

Rate 

Modem Type 

Asynchronous 

1200 

212 A 


300 

103 A 


INSTALLATION DESCRIPTION 

The installation of TIGS 1 with the Sanders Graphic 7 post 
processor allows the user the option of generating either 
a segment/overlay loader library, TGR7LIB or both a 
segment/overlay loader library, TGR7LIB, and a basic 
(nonsegment/nonoverlay) loader library, TGR7SFL. 

The segment/overlay loader library, TGR7LIB, can be 
used in those situations where memory requirements of 
graphic applications exceed the available NOS/BE field 
length. The user can employ the segment/overlay loader 
library, TGR7LIB, in conjunction with CYBER loader 
to segment or to overlay a graphic application and thereby 
reduce memory requirements. Note that use of the 
segment/overlay loader library, TGR7L3B, without seg¬ 
mentation or overlays increases an application program 
field length requirement. For example, the installation 
verification program VRFY requires 56374 (octal) field 
length using TGR7SFL and 62432 (octal) field length using 
TGR7LIB without segmentation or overlays. 

The basic (nonsegment/nonoverlay) loader library, 
TGR7SFL, can be used for graphic applications with 
memory requirements that do not exceed the NOS/BE 
available field length. 

TGR7LIB is installed by default by the installation job. 
Both TGR7LIB and TGR7SFL are installed by the installa¬ 
tion job b}' specifying -DEFtNE, BASIC LDR as an UPDATE 
directive. 

The installation of TIGS 1 with the Sanders Graphic 7 post 
processor requires the installation of a PP routine into 
the rumiing system. The PP routine, GCC-Change Pro¬ 
gram to Graphics Classification, gives the calling pro¬ 
gram graphics classification for the duration of program 
execution and returns the page width and length to the 


The amount of refresh memory available in the Sanders 
Graphic 7 terminal must be specified during installation 
of the post processor. The allowable sizes of refresh 
memory are 8K, 16K, and 24K words. Table II-10-3 
lists these options and the corresponding installation job 
directives. 

TABLE n-10-3. REFRESH MEMORY SIZES 

Refresh Required 

Memory Installation Job 

Size UPDATE Directive 

8K words -DEFINE, REF8K 

16K words -DEFINE, REF16K 

24K words -DEFINE,REF24K 

INSTALLATION PROCEDURE 

The procedure for installation of TIGS 1 wdh the Sanders 
Graphic 7 post processor is outlined in the following two 
steps. 

Step 1. 

The installation job is file 1 on the Sanders Graphic 7 post 
processor release tape (PL86C). File 1 is a program 
library in UPDATE format with - (equals) as the master 
control character. 

A dummy ACCOUNT card has been included as part of the 
installation job. Perform an UPDATE run against file 1 
of PL86C and list the COMPILE file to obtain the sequence 
number which corresponds to the ACCOUNT card (and 
any other control cards) which must be modified for 
installation. A listing of the COMPILE file may be obtained 
by executing the following procedure: 

{ MTl'j (7-track, 800 bpi.) 
HD1 J . (9-track, 800 cpi.) 
PEIj (9-track, 1600 cpi.) 
ACCOUNT(*) (Supply appropriate accounting- 

information. ) 

LABEL(TIGSPL, R, L-TIGSANDV1, 



( HY ) 

(7-track, 800 bpi.) 

D= 

{hd} ,VSN=PL86C) 

(9-track, 800 cpi.) 


(pe) 

(9-track, 1600 cpi.) 


COPYBF(TIGSPL, OLDPL) 
UNLOAD (TIGSPL) 

UPDATE(F, U, *=, L-17) 

COPYSBF(COMPILE, OUTPUT) 
7/8/9 

-IDENT, INSTALL 
-DEFINE, NOSBE 



( HY ) 

(7-track. 

800 bpi/ 

DEFINE, 

HD 

(9-track. 

800 cpi/ 


IpeJ 

(9 -track. 

1600 cpi 
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^DEFINE, BASICLDR 


I REF8K 
REF16K 
REF24K 


6/7/8/9 


(This is an optional UPDATE 
directive. If the user wishes 
to install both a segment/ 
overlay loader library 
(TGR7LIB) and a basic 
(nonsegment/nonoverlay) 
loader library (TGR7SFL), 
then this DEFINE statement 
must be included. If this 
DEFINE statement is not 
included, then only the con¬ 
trol cards required to 
install a segment/overlay 
loader library will be listed.) 


(Specify the amount of re¬ 
fresh memory available in 
the terminal.) 


Step 2 


Perform a full UPDATE on file 1 of the Sanders Graphic 7 
post processor release tape, (PL86C), modifying the 
installation job program library with the appropriate 
accounting information and DEFINE UPDATE directives 
required for installation. Route the resulting installation 
job to the NOS/BE input queue by executing the following 
procedure. NOTE: Only the Sanders Graphic 7 post 
processor release tape (PL86C) is required for the 
EXTRACT job, but both the Sanders Graphic 7 post pro¬ 
cessor release tape (PL86C) and the TIGS 1 preprocessor 
release tape (PL86A) are required for the installation job 
routed to the NOS/BE input queue. 


EXTRACT, T10, CM65000, 

I MTl] (7-track, 800 bpi.) 

HD1 > . (9-track, 800 cpi.) 

PEI ) (9-track, 1600 cpi.) 

ACCOUNT(*) (Supply appropriate accounting 


information.) 


LABEL(TIGSPL, R, L=TIGSANDV1 



(mr) 

(7 -track, 800 bpi.) 

D= 

l HD 

,VSN=PL86C) (9-track, 800 cpi.) 


IpeI 

(9-track, 1600 cpi.) 


C OP YB F (TIGSP L, OLDPL) 
UNLOAD (TIGSPL) 
REQUEST(COMPILE, *Q) 
UPDATE(F, *=, L=17, D, 8) 
ROUTE (COMPILE, DC=IN) 
7/8/9 


=IDENT, INSTALL 
=DE FINE, NOSBE 

. HY 

^DEFINE, 


(7-track, 800 bpi.) 
(9-track, 800 cpi.) 
(9-track, 1600 cpi.) 


^DEFINE, BASIC LDR (This is an optional UPDATE 
directive. If the user wishes 
to install both a segment/ 
overlay loader library 
(TGR7LEB) and a basic 
(nonsegment/nonoverlay) 
loader library (TGR7SFL), 
the =DEFINE, BASIC LDR 
directive must be included 
as part of the UPDATE. If 
the =DEFINE, BASIC LDR 
directive is not included as 
part of the UPDATE, then 
only a segment/overlay 
loader library (TGR7LIB) 
will be installed.) 

I REF8K \ 

REF16K > 

REF24K j 

(Specify the amount of re¬ 
fresh memory available in 
the terminal.) 

=D, TIGS1.9 

ACCOUNT( ) (The user must modify the 

installation job program 
library with appropriate 
accounting information. The 
dummy ACCOUNT card 
sequence number, 9, was 
obtained from the compile 
file listing resulting from 
step 1 of the ’’Installation 
Procedure. ”) 

6/7/8/9 


VERIFICATION PROCEDURE 

Use the following steps for verification: 
Step 1 


The verification job is file 5 on the Sanders Graphic 7 
post processor release tape, (PL86C). File 5 is a pro¬ 
gram library in UPDATE format with = (equals) as the 
master control character. 

A dummy ACCOUNT card has been included as part of 
the verification job. Perform an UPDATE run against 
file 5 of PL86C and list the COMPILE file to obtain the 
sequence number which corresponds to the ACCOUNT 
card (and any other control cards) which must be modified 
for installation. A listing of the COMPILE file may be 
obtained by executing the following procedure: 
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Step 3. 


I MTl] (7-track, 800 bpl.) 
HD1 i . (9-track, 800 bpi. ) 
PEI j (9-track, 1600 cpi.) 
ACCOUNT^) (Supply appropriate account¬ 

ing information.) 

LABEL(TIGSPL,R, L-TIGSANDV1, 

I HY] (7-track, 800 bpi.) 

HD J , VSN-PL86C) (9-track, 800 cpi.) 

PE j (9-track, 1600 cpi.) 

SKIPF(TIGSPL, 4,17) 

COPYBF(TIGSPL, OLDPL) 

UNLOAD (TIGSP L) 

UPDATE (F, U, *=, L=17) 

C OP YSB F(C OMPILE, OUTPUT) 

7/8/9 

-IDENT, VERIFY 
-DEFINE, NOSBE 
6/7/8/9 

Step 2. 

Perform a full UPDATE on file 5 of PL86C modifying the 
verification job program library with the appropriate 
accounting information and DEFINE UPDATE directives 
required for installation. Route the resulting verification 
job to the NOS/BE input queue by executing a procedure 
of the following form: 


Run the verification program, catalogued as permanent 
file VRFY by the verification job, to verify the proper 
installation of TIGS 1. The verification program may be 
run as follows: 

1. Refer to the ’’Terminal Operating Procedures” to 
properly set up the terminal. 

2. Log in to NOS/BE - INTERCOM 5 with a valid 
user name and password. 

3. Attach the segment/overlay loader library per¬ 
manent file and declare TGR7LEB a library: 

ATTACH(TGR7LIB, ID-SAND) 

LIBRARY (TGR7LIB) 

4. Attach the verification program permanent file 
and execute the verification program: 

ATTACH(VRFY, ID-TIGS) 

VRFY. 

5. The terminal operator will be asked if a lightpen 
is available (see figure II-10-5). Enter Y if it is 
available; otherwise, enter N. 


XTRACT, T10, CM65000, 

I MT1 \ (7-track, 800 bpi.) 

HD1 \ . (9-track, 800 cpi.) 

PEI J (9-track, 1600 cpi.) 

ACCOUNT^) (Supply appropriate accounting 


information.) 

LABEL(TIGSPL, R, L-TIGSANDV1, 

I HY | (7-track, 800 bpi.) 

HD > , VSN-PL86C) (9-track, 800 cpi.) 
PE ) (9-track, 1600 cpi.) 

SKIPF(TIGSPL, 4,17) 

C OP YB F(TIGSP L, OLDPL) 

UNLOAD (TIGSP L) 

RE QUEST (C OMPILE, * Q) 

UPDATE(F, *==, L-17, D, 8) 

ROUTE (COMPILE, DC-IN) 

7/8/9 


6. The terminal operator will be asked if a trackball, 
or joystick, is available (see figure II-10-5). 

Enter Y if it is available; otherwise enter N. 

7. The terminal operator will be asked if a hardcopy 
unit is available (see figure II-10-5). Enter N. 
The verification program does not require the 
availability of a hardcopy unit. 

8. The terminal operator will be asked if the error 
display should be enabled (see figure II-10-5). 
Enter Y. 

9. Figure II-10-6 will be displayed. 

10. If neither a lightpen nor a trackball (joystick) are 
available, operations 11 through 14 are skipped. 


-IDENT, VERIFY 
-DEFINE, NOSBE 
=D, TIGS2.4 

ACCOUNT( ) (The user must modify the 

verification job program 
library with appropriate 
accounting information. The 
dummy ACCOUNT card 
sequence number, 4, was 
obtained from the compile 
file listing resulting from 
step 1 of the ’’Verification 
Procedure. ”) 


11. The operator is allowed to pick one of three 
buttons: WINDOW, RESTORE, or QUIT. The 
button is picked in one of the following ways: 

• If the lightpen is available, the operator 
positions the pen tip over the text of the 
button and depresses the tip. 

• If only the trackball (joystick) is avail¬ 
able, the operator positions the center 
of the cursor over the text of the button 
and depresses the function key labelled 
F0. 


6/7/8/9 


• 11 - 10-10 
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IS LIGHTPEN AVAILABLE -CY/N> 

Y 

IS TRACKBALL/JOYSTICK AVAILABLE TY/N> 

Y 

IS HARDCOPY UNIT AVAILABLE -CY/NT 
N 

SHOULD ERROR DISPLAY BE ENABLED -CY/N3- 

Y 


Figure II-10-5. Terminal User is Asked to Enter Availability of Lightpen, Trackball/Joystick, and 

Hardcopy, and Whether Error Display is to be Enabled 














12. If WINDOW is picked, the terminal operator will 
be asked to locate the lower-left and then the 
upper-right corner of a new window to display. 
This is done in one of the following ways: 

• If the lightpen is available, the operator 
positions the pen tip at the lower-left 
corner of the window selected, and 
depresses the tip, and then does the 
same for the upper-right corner. 

Finally the operator depresses the 
function key labelled F15, after waiting 
for prompting at each step. 

• If only the trackball (joystick) is avail¬ 
able, the operator positions the center 
of the cursor at the lower-left corner 
of the window selected and depresses 
the function key labelled F0, and then 
does the same for the upper-right 
corner. Finally the operator depresses 
the function key labelled FI5, after 
waiting for prompting at each step. 

13. If RESTORE is picked, the original display is 
displayed. 

14. If QUIT is picked, the verification program 
terminates. 

15. If a basic (nonsegment/nonoverlay) loader 
library, TGR7SFL, was not installed, then go 
to operation 19. 

16. Attach the basic (nonsegment/nonoverlay) loader 
library permanent file and declare TIGSSFL a 
library: 

ATTACH(TGR7SFL, ID-SAND) 

LIBRARY (T GR 7 SF L) 

17. Execute the verification program: 

VRFY. 


18. Repeat operation 5 through 14 to verify the basic 
(nonsegment/nonoverlay) loader library, 

TGR7SFL. 

19. Purge any unnecessary files generated during 
the installation or verification of TIGS 1. 

20. Log off when finished. 

TERMINAL OPERATING PROCEDURES 

The Sanders Graphic 7 operating procedures are as 
follows : 

1. Turn the terminal power on by pushing in the 
ON/OFF button on the front of the display and 
flipping the ON/OFF switch, located behind the 
front panel of the controller unit, to ON. 

2. Push the LOCAL button on the front panel of the 
controller unit to bring up a test pattern on the 
display screen. 

3. Depress the carriage return key on the keyboard 
to bring down the test pattern. An M will appear 
in the center of the screen. Then depress Y 
followed by carriage return. A G7 F will appear 

at the top of the screen indicating that the terminal 
is in teletype emulation mode. 

4. Switch the terminal to half duplex by depressing 
the function key labelled FI. 

5. Turn the modem power on and verify that the 
modem is connected to the terminal. 

6. Dial the appropriate phone number. 

7. INTERCOM Version 5 requires the user to press 
the RETURN key after the terminal is polled 
before it will respond with a LOGIN message. 
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TOTAL UNIVERSAL 1 


RELEASE DESCRIPTION 

TOTAL Universal 1 consists of the following relocatable 
binaries: 

DBGEN (Data base generation program) - this program 
reads user-prepared DBDL statements and generates 
COMPASS source statements which in turn produce the 
data base descriptor module. 

DBFMT (Data set format program) - this program reads 
format parameter statements, and, utilizing a data base 
descriptor module, preformats the data sets. 

DATBAS (Data base interface module) - this module 
serves as an interface between the user application pro¬ 
gram and the TOTAL and data base descriptor modules. 

TOTAL (Data base management module) - this module 
provides the data management capability of the system, 
interpreting and executing the various DML commands 
from the user application program. 

DBRCV (Data base recovery module) - this module, 
optional in use, provides the ability to recover record 
images from the TOTAL logging file. 

These files are to be installed on the user’s permanent 
file library. 

Hardware Requirements 

TOTAL Universal 1 can be maintained and run on the same 
minimum hardware requirements as NOS/BE. 


Deficiencies 

None. 


INSTALLATION PROCEDURES 

TOTAL Universal 1 resides on the tape PL49. PL49 is 
a program library in binary format. It has the following 
characteristics: labeled, 7- or 9-track, 800 bpi, binary 
recording mode, TOTALU1PO as file ID in HDRl label, 
six files: 

File 1 - installation and verification deck in UPDATE 
format, 

File 2 - empty, 


File 3 - five TOTAL relocatable binaries (described 
earlier), 

File 4 - empty, 

File 5 - empty, and 

File 6 - sample output of installation and validation 
job. 

Installation consists of the following steps: 

1. Determine update directives to modify the install 
deck (as described in the next section). 

2. Create the following job to call the install/ 
validate job from the install tape and submit it as 
a batch job: 

JOB/ACCOUNT. (Supply valid JOB/ 

ACCOUNT card.) 

LABEL, TOT, R, L=TOTALU1PO, D=HY, 
VSN=PL49. 

REQUEST, COMPILE, *Q. 

UPDATE, Q, * =$$$$, P=TOT, L=F. 

ROUTE, COMPILE, DC =JN. 

7/8/9 

UPDATE directives 
6/7/8/9 

3. Validate the install/validate job output against 
the sample output copied from the install tape. 


INSTALLATION PARAMETERS 

Following is a sample UPDATE directive deck to be used 
as described in the previous section. All options are 
shown and explained. 

SINST 

SCOMPILE INSTALL 

JSDEFINE MT | (7-track install tape.) 

(SDEFINE NT ) (9-track install tape.) 

SDELETE INSTALL. 2, INSTALL. 3 
JOB/ACCOUNT (Site/user dependent.) 

INSTALLATION JOB 

The installation/validation job performs the following: 

1. Issue LABEL to have install tapes assigned to job. 

2. REQUEST’S permanent file space for the five 
TOTAL files, copies them from tape to the perma¬ 
nent files, and catalogues the permanent files as 

in the following example (no passwords are 
assigned): 

CATALOG, DBGEN, ID=TOTAL 
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3. Validation is begun by defining a data base using 
DBGEN. 

4. The test data base is formatted with DBFMT. 

5. Sample data is placed in the data base with a 
COBOL program, and retrievals are performed. 
DATBAS and TOTAL are verified in this phase. 

6. DBRCV is next run against the data base for its 
validation. 

7. Finally, the sample output of the install/validation 
job is copied from the install tape to output. 


TOTAL UNIVERSAL 2 


RELEASE DESCRIPTION 

TOTAL Universal 2 consists of the following relocatable 
binaries: 

DBGEN (Data base generation program) - this program 
reads user-prepared DBDL statements and generates 
COMPASS source statements which in turn produce the 
data base descriptor module. 

DBFMT (Data set format program) - this program reads 
format parameter statements, and, utilizing a data base 
descriptor module, preformats the data sets. 

DATBAS (Data base interface module) - this module 
serves as an interface between the user application pro¬ 
gram and the TOTAL and data base descriptor modules. 

TOTAL (Data base management module) - this module 
provides the data management capability of the system, 
interpreting and executing the various DML commands 
from the user application program. 

DBRCV (Data base recovery module) - this module, 
optional in use, provides the ability to recover record 
images from the TOTAL logging file. 

TOTUTIL (TOTAL utilities) - this program provides 
TOTAL users with a generalized utility package capable 
of performing file loading/unloading, statistics, and 
other data base functions. 

These files are to be installed on the user’s permanent 
file library. 


Hardware Requirements 

TOTAL Universal 2 can be maintained and run on the same 
minimum hardware requirements as NOS/BE. 


RELEASE MATERIALS 

TOTAL UNIVERSAL 2 release materials are contained 
on program library tape PL75. PL75 has the following 
characteristics: labeled, 7-track (800 bpi) or 9-track (800 
or 1600 cpi), binary recording mode, TOTALU2PO as file 
ID in HDRl label. PL75 contains seven files: 

File 1 - installation and verification deck in UPDATE 
format, 

File 2 - empty. 

File 3 - five TOTAL relocatable binaries: DBGEN, 
DBFMT, DATBAS, TOTAL, DBRCV, 

File 4 - source code for TOTAL utilities in UPDATE 
format. 

File 5 - empty, 

File 6 - COBOL compilation output from the validation 
job, and 

File 7 - execution output from the validation job. 


INSTALLATION PROCEDURES 

Installation consists of the following steps: 

1. Determine UPDATE directives to modify the 
install deck (as described in the next section). 

2. Create the following job to call the install/ 
validate job from the install tape and submit it 
as a batch job: 

JOB/ACCOUNT. (Supply valid JOB/ 

ACCOUNT card.) 

LABEL, TOT,R,L=TOTALU2PO,D= ( HY \ , 
VSN=PL75. | HD \ 

REQUEST, COMPILE, *Q. ( PE ) 

UPDATE, Q, *-$$$$, P=TOT, L=F. 

ROUTE, COMPILE, DC=IN. 

7/8/9 

UPDATE directives 

G/7/8/9 

3. Validate the install/validate job output against 
the sample output copied from the install tape. 


INSTALLATION PARAMETERS 

Following are the UPDATE directives to be used as de¬ 
scribed in the previous section. All options are shown 
and explained. 


Deficiencies 

None. 
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$IDENT INST 
$DEFINE CBL4^ 

$DEFINE HY J 
$DEFINE HD | 
$DEFINE PE J 


(Compiles utilities with COBOL 4 - 
Default is COBOL 5) 

(7-track 800 bpi) \ Select one to 
(9-track 800 cpi) > correspond to 
(9-track 1600 cpi )) the installation 


tape density. 

$DELETE INSTALL. 2, INSTALL. 3 
JOB/ACCOUNT CARD. (Supply valid JOB/ 


ACCOUNT card.) 

$COMPILE INSTALL 


INSTALLATION JOB 


6. Sample data is placed in the data base with a 
COBOL program, and retrievals are performed. 
DATBAS and TOTAL are verified in this phase. 

7. DBRCV is run against the data base for its 
validation. 

8. The TOTAL utilities are validated by executing 
the statistics option. 

9. Finally, the sample output of the install/validation 
job is copied from the install tape to output for 
verification. 


The installation/validation job performs the following: FILES CREATED 


1. Issues LABEL card to have install tape assigned The installation/validation job creates the following perma- 

to job. nent files with ID=TOTAL and no passwords assigned: 


2. REQUESTS permanent file space for the five 
TOTAL files, copies them from tape to the perma¬ 
nent files and catalogues the permanent files as 

in the following example: 

CATALOG, DBGEN, ID=TOTAL. 

3. Compiles TOTAL utilities and creates the 
relocatable binary on the permanent file 
TOTUTIL. 


DBGEN 

DBFMT 

DATBAS 

TOTAL 

DBRCV 


Five TOTAL binaries 


TOTUTIL - 
CUSTDB - 
CUCUST | 
CUINVF | 


TOTAL utility binary 
Validation DBMOD 

Validation data base files 


4. Validation is begun by defining a data base 
using DBGEN. 


The user should insure that these files will not conflict 
with already existing files prior to installation. 


5. The test data base is formatted with DBFMT. 


tThe ability to compile the utilities using COBOL 4 is provided as a user convenience at this time, but may not be 
supported in future releases. 
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RELEASE DESCRIPTION 

| TOTAL/ATHENA consists of four relocatable binaries: 

ATB1 | Modules that interface with the TOTAL 

ATB2 I data k ase management system. 

I ATRP = the Report Writer module. 

ATPLT =■ the Plotter module. 


HARDWARE REQUIREMENTS 

TOTAL/ATHENA can be maintained and run on the same 
minimum hardware requirements as NOS/BE. 


SOFTWARE REQUIREMENTS 

| TOTAL Universal 2 must be installed before TOTAL/ 
ATHENA installation is attempted. 


INSTALLATION PROCEDURES 


PL62 contains six files: 

File 1 - install deck in UPDATE format, 

File 2 - empty, 

File 3 - four relocatable binaries: 

TOTAL/ATHENA query update 
binaries, 

TOTAL/ATHENA Report Writer, and 
-ATPLT TOTAL/ATHENA Plotter; 

File 4 - TOTAL/ATHENA, Report Writer, and Plotter 
source code deck in UPDATE format, 

File 5 - demonstration decks in UPDATE format: 

-TOTAL/ATHENA, 

-REPORT WRITER, 

-PLOTTER, and 
-TEXT INFORMATION; 

File 6 - sample output from demonstration jobs. 

Installation consists of the following steps: 

1. Choose the UPDATE directives that are required in 
step 2 to modify the install deck. 


-ATB1 \ 
-ATB2 j 
-ATRP 


a. Select a DEFINE,MT or DEFINE, NT or DEFINE, 
NTPE for install tape processing. 

b. Select a DEFINE,BINARY or DEFINE, SOURCE. 
For execution of TOTAL/ATHENA, Report Writer 
and Plotter compiled binaries, select the DEFINE, 
BINARY. For users to compile their own copies 
of TOTAL/ATHENA, Report Writer and Plotter, 
select the DEFINE,SOURCE control directive. 

c. Select DEFINE, DEBUG if COBOL DEBUG mode 
is desired. 


2 . 


Create and submit for batch processing the following 
job to call the install deck from the install tape: 

JOB, IhDI \ . 

I PEI j 

ACCOUNT. f HY ) 

LABEL, ATH, R, L=TOTALATHENA, D= j HD \ , 
VSN=PL62. IPe) 

REQUEST, COMPILE, *Q. 

UPDATE(Q, P=ATH, L=F,*=/) 

ROUTE (C OMPILE, DC=IN) 

7/8/9 
/ID INST 


{ MT (7 TRACK TAPE) \ 
NT (9 TRACK TAPE) I 
NTPE | 

(9 TRACK TAPE - 1600 cpi) / 
/DEFINE (SOURCE| 

(BINARY) 

[ /DEFINE, DEBUG] 

/DELETE INSTALL. 2, INSTALL. 3 
( MT11 
JOBNAME |kD1| 
l PEI j 


(Select MT, NT 
or NTPE) 

Select BINARY 
or SOURCE 


(choose) 


ACCOUNT. (Insert correct ACCOUNT here.) 
/D INSTALL. 103,INSTALL. 104 
( MT1J 

JOBNAME, T200, | HD1 1 (choose) 

l PEI J 


ACCOUNT. (Insert correct ACCOUNT here.) 
/COMPILE INSTALL 
6/7/8/9 


3. Verify that the output from the demonstration job 
matches the listing of the install tape sample output 
file. Verify that the output obtained from interactively 
executing the ATHENA plotter matches the output 
listed in the demonstration job text file. 
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INSTALLATION JOB 


DEMONSTRATION JOB 


The installation jobs perform the following: 

1. Issue LABEL to have PL62 assigned to job. 

2. For installation of the binary files (/DEFINE,BINARY), 
the install job defines the two TOTAL ATHENA files, 
the Report Writer and Plotter files, and copies them 
from release PL62 to the permanent files. No pass¬ 
words are assigned. 

3. For the user to compile binaries from source code 
(/DEFINE,SOURCE) the install job defines the two 
TOTAL/ATHENA files, the Report Writer file and 
Plotter file, copies and updates the source code from 
tape to disk and compiles the source code generating 
TOTAL/ATHENA, Report Writer and Plotter binaries. 

4. A TOTAL/ATHENA demonstration is begun by defining 
a data base using DBGEN (TOTAL module). 

5. A test data base is formatted with DBFMT (TOTAL 
module). 

6. Sample data is placed in the data base with TOTAL/ 
ATHENA and then TOTAL/A THEN A retrievals and 
functions are performed. 

7. A TOTAL/ATHENA Report Writer demonstration is 
then processed with SUBSET and COMMAND file data 
supplied on the install tape. 

8. A TOTAL/ATHENA plotter demonstration should then 
be run interactively by the installer. The plotter data 
base and a text file of instructions to the installer is 
supplied on the install tape. The needed files are 
catalogued by the installation job, and the text file of 
instructions is printed out following the ATHENA Re¬ 
port Writer demonstration. 

When the plotter verification is complete, the installer 
should compare all the demonstration output with the 
expected output which was copied from the install tape. 

This job lists the install deck as it appears on file 1 of 

PL62: 


The demonstration deck in UPDATE format includes the 
demonstration job and the necessary input records to the 
demonstration job. The demonstration job performs these 
operations: 

1. Generates a TOTAL DBNIOD and formats a TOTAL 
data base. 

2. Creates and executes the TOTAL/ATHEXA query/ 
update executable binary. 

3. Executes the TOTAL/ATHENA report generator 
module. 

4. Defines and copies a TOTAL/ATHENA plotter 
SUBSET file. 

5. Prints a text file that describes how to verify the 
TOTAL/ATHENA plotter. 

This job lists the demonstration deck as it appears on 
file 5 of the install tape: 


I MTl] 

HDll . 

PEI j 

ACCOUNT. 

LA BE L(A TH, R, L=TOTA LA TH ENA, D= 

VSN=PL62) 

SKIPF, ATH, 4,17. 

UPDATE(Q, L=F, P=ATH, *=$$$$,R) 
7/8/9 

$ID ATHLIST 
$COMPILE TADEMO 
6/7/8/9 



NOTE 


The binary files on this release were 
generated on a non-CMU CYBER system. 


I MTlV 

HD1 V . 

PEl) 

ACCOUNT. 

( HY | 

LABEL(ATH, R, L=TOTA LATHENA, D= I HD } 
VSN=PL62) (peJ 

UPDATE(Q, L=F, P=ATH, *=/) 

7/8/9 

/ID ATHLIST 
/COMPILE INSTALL 
6/7/S/9 


II-12-2 


76071100 S 



UNIPLOT 2 


13 


RELEASE DESCRIPTION 


UNIPLOT 2 (Universal Plotting Software Version 2) runs 
under NOS/BE to provide a standard interface between an 
application program and various plotting or display devices. 

The UNIPLOT subroutines are callable from user applica¬ 
tion programs only under FORTRAN Extended, and pro¬ 
vide the user with a standard format plot data file and the 
capability of obtaining a plot on a variety of devices with¬ 
out regenerating the data. 

The installation of UNIPLOT 2 requires the installation of 
the device dependent plot routines supplied by the plotter 
manufacturer. 

HARDWARE CONFIGURATION 

The minimum hardware configuration required by NOS/BE 
is required to support UNIPLOT. 

HARDWARE OPTIONS 

A graphics terminal or plotting device is required if 
plotting or displaying of plot data is desired to be done 
in-house. Those currently supported by UNIPLOT are: 

1. CalComp r s 500 and 700 series plotters and 
controllers, 

2. Houston Instruments BRC-7 and MTR-4 
controllers, 

3. ZETA models 230, 1240 and 3640, 

4. Tektronix 40XX series graphics terminals, and 

5. Control Data CYBER graphics terminal. 


RELEASE MATERIALS 


UNIPLOT 2 release consists of a single magnetic tape, 
PL71, containing six files of data as follows: 

File 1 - installation/maintenance job program library, 

File 2 - absolute overlay of UNIPLOT post-processor, 

File 3 - user library of UNIPLOT neutral plot 
routines in EDITLIB format, 

File 4 - program library of UNIPLOT in UPDATE 
format, 


File 5 - verification job program library, and 
File 6 - empty. 

PSR MODIFICATIONS 

The PSR deck on the corrective code tape which is appli¬ 
cable to UNIPLOT 2 is UNP. The idents within this deck 
are of the form UNPxxxx. The initial release of PL71 is 
at LV444. 

The UNIPLOT 2 installation/maintenance job assumes that 
the PSRs are on a permanent file called MINIT, ID=CCT. 
MINIT is assumed to be a program library with a master 
character of / (slash). 

NOTES AND CAUTIONS 

All limitations applicable to NOS/BE also apply to 
UNIPLOT 2. 

All subroutines in UNIPLOT are callable from user appli¬ 
cation programs in FORTRAN Extended only. 

If the ZETA or Tektronix devices are to be used, INTERCOM 
is required. 


INSTALLATION PROCEDURE 


The installation of UNIPLOT 2 requires the cataloging of 
the UNIPLOT 2 neutral plot routine library and the post¬ 
processor absolute (UNIPOST). The job required to 
install UNIPLOT 2 is released as an installation deck on 
file 1 of the release tape. This job is a program library 
in UPDATE format with = (equal) as the master character. 
A dummy ACCOUNT card is part of this job. The user 
should first perform an UPDATE run and list the compile 
file to discover the sequence numbers. As part of the 
EXTRACT procedure, the user should modify the JOB/ 
ACCOUNT cards to conform to this installation. 

To obtain and execute the installation or maintenance job, 
a procedure of the form shown below should be used: 

EXTRACT, P 

ACCOUNT. (Supply valid ACCOUNT card.) 

LABEL(PL71, R, L=UNIPLOTV2, D= j H ^ , 
VSN=PL71) ' H * 

COPYBF(PL71, OLDPL) 

REWIND(OLDPL) 

UPDATE(Q, *= =, C, D, 8) 

ROUTE(CC)MPILE, DC=IN) 

7/8/9 
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=D, INSTA L. XX 
=D PSR.XX 
ACCOUNT. 
-COMPILE INSTAL 
-COMPILE PSR 
6/7/8/9 


(Use for initial installation.) 
(Use for maintenance run.) 

(Use for initial installation.) 
(Use for maintenance run.) 


Both the installation and maintenance jobs initiated by the 
EXTRACT job will catalog the following three permanent 
files. 


File 1 - UNIPOST,ID-UNIPLOT - absolute code for 
UNIPLOT post-processor, 

File 2 - UNIPLOT, ID-UNIPLOT - user library of 
UNIPLOT neutral plot routines, and 

File 3 - POSTLGO, ID-UNIPLOT - relocatable binary 
of UNIPLOT post-processor. 


The maintenance run, when the IDENT PSR is used will, 
in addition, generate a new PL71 tape containing the 
corrective code. 


In order to support a new plotting device, the programmer 
must write a new overlay main program that calls initiali¬ 
zation, vector plotting, pen select, termination and 
possible character plotting routines specific to the device 
being supported. The subroutine DEVLIST in the main 
overlay must be modified to include the keyname of the 
new overlay. Then the post-processor must be reloaded 
along with the new overlay. 


MODIFYING ROUTINE DEVICE LIST 

The modifying routine device list (DEVLIST) conforms to 
the following: 

1. The dimension of the array DEVICE must be in¬ 
cremented by the number of devices added. 

2. The name and decimal overlay number of the new 
plotting device must be added at the end of the 
list of device names in the DATA statement. This 
name is in the form of a Hollerith string and may 
be from one to seven characters long. 


INSTALLING A NEW DEVICE 


3. The value of variable MAXDEV is set by an as¬ 
signment statement: 


A labeled common block, / PPREQ/, is used by the post¬ 
processor main overlay to communicate with the device 
routines in the primary overlay. Each time control is 
returned to the primary overlay, 7 PPREQ/ contains 
information which directs the overlay’s main program to 
call a specific device routine with parameter values 
also contained in 7 PPREQ/. 


M AXDE V-cons tant 

The constant must be incremented to conform to 
the number of devices supported and thus to the 
sizes of array DEVICE. 

A listing of routine DEVLIST is given in figure II-13-1. 


subroutine nevusi 


c 


UtVLUI CONTAINS ThE LIbT OF DtVICE KF YNAME s AND ThE 
fOwh-f SENDING OvFxLAv' NUmHFR In ThE DEVICE A Rp AY. 

NUF VICt CONTAINS W. KEYNAME SPECIFIED HY ThE DEVICE 
0IRECT1VF. 

NOVtR CONTAINS The OVERLAY NUMRFR OF Tnt SPECIFIED 
VICE AhRIVFD AT Hy MASKING OUT THE DISPLAY CODE OF 
ThE NUMBER and CONVERTING IT TO AN INTEGER. 

TO ADu A NEM >EVTCE *t YNAMF FOLLOW THESE STEPS 

i. Increase Th£ DEVICES DIMENSION STATEMENT AND THE 
00 LOOP INDEX By the number OE OFVICES TO he ADDED. 

add the ► E ynAmf and OVEPLAY NUMRER IN DECIMAL 
TO DEVICE" IN 1UHXXXXXXXNNN FORMAT. REMEMREP 
THfT T«t uVt-I.AY CAPO IT^FI.F MUST Hf IN OCTAL. 

COMMON /''tVl'E/ NOE V ICE .N'ivER 
iNTEGtw DtvICE (8) 

Oan (OtViCF ( I ) . I = 1 ,u) 

1 'IOmPunp oui. 

1 0~Cal (70 OOd * 

j IOhhIctoO n0<+. 

“ 10HCUU0 7T 0 0*a. 

5 IOhTEk 0(w. 

6 lOH/tn- o 1 u • 

7 10hCal b7J 01 m. 

« 10U7/ "dJs 


MAX OF. v = 8 
NOVEk=0 

DO 100 INl=1.MAXDEV 

IF (AM) (MASK U?) • DE. V ICE ( InD) ) .EQ. 

1 AND (MASK (<.?) .NOEVTCh ) ) 60 TO 2oo 

10 ) CONTI Nut 
RETURN 
C 

C CONVEkI OVERLAY NiJMtJEH 

C 

Z0-U Njm-SHIFT (OF VICE ( I NO) .*♦*) 

DO «*S « 1 = 1 .3 
1 01 •. I T=..Uu ( MUM . / 7 h ) - I.jh 
IF (lDiGlT.tO.0) u > TO 

nuve:r=iu«nuver* miGiT 

?b0 NU--SHIFT (NUM.M 
Kf T.jhn 
END 


Figure II-13-1. Subroutine DEVLIST 
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WRITING A NEW OVERLAY MAIN PROGRAM 


INITIALIZATION REQUEST (IREQ = 0) 


The design requirements on an overlay main program are 
as follows: 

1. That it call device dependent routines in order to 
plot the graphic data specified in common 
/PPREQ/. (Details follow in 2 and 3.) 

2. That upon being entered with an initialization re¬ 
quest, it enters into /PPREQ/ a list of properties 
and parameters of the device that the overlay 
supports before the first call to NPFDATA. 

3. That the overlay make calls to a main overlay 
subroutine NPFDATA to obtain data from the 
neutral picture file. The NPFDATA subroutine 
will set the /PPREQ/ common block and return 
to the overlay. Thus, the overlay will loop, 
calling NPFDATA until processing is complete. 

The name of the overlay must be UNIPOST and the number 
must be in octal and correspond to the decimal number of 
the name of the device in table DEVICE in subroutine 
DEVLIST. 

If the device initialization routine specifies a fixed file 
name on which plot commands are to be written, the file 
should be 5LPLOTF. If the device routines open the file 
specified in the PLOTS call, IPRM(2) should be used on 
the IREQ=0 request. 


INTERFACE WITH THE DEVICE ROUTINES 

The manufacturer-supplied, device-dependent subroutines 
for each different plotting device are loaded in different 
overlays. Each overlay has a custom-written main pro¬ 
gram that calls a working routine in the main (0,0) over¬ 
lay to pick up request codes and parameters from the 
neutral picture file. Upon return to the primary overlay, 
these codes and respective parameters are in the PPREQ 
common block. The codes direct the primary overlay’s 
main program to call a specific device dependent routine 
with the parameters supplied. 

The PPREQ common block is defined as follows: 

COMMON/PPREQ/IREQ, IPRM(31) 
DIMENSION FPRM(31) 

EQUIVALENCE(IPRM, FPRM) 

IREQ is an integer the value of which specifies the kind of 
request being made. IPRM is an array that contains inte¬ 
ger parameters to be used in carrying out the request. 
FPRM is an array that contains floating point parameters 
to be used in carrying out the request. The requests are 
listing in the following paragraphs. 


The overlay is requested to initialize itself and to return 
to the main program certain information about the display 
device serviced by the overlay. It is usually a requirement 
of the device specific subroutines that they be initialized 
only once in a run unless PLOT(X, Y, 999) has been called. 

Upon entry into the overlay with IREQ 0, the IPRM array 
is set as follows: 


IPRM(l) = device keyname, and 

IPRM(2) = logical unit number or name of the device 
dependent plot file, default of PLOTF. 

The primary overlay main program then sets the values in 
PPREQ as follows: 


Code 


Definition 


IPRM(l) 


FPRM(2) 

FPRM(3) 

IPRM (4) 
IPRM(5) 

IPRM(6) 

IPRM(7) 

IPRIvI(8) 

IPRM (9) 

IPRM (10) 
IPRM(ll) 


Device type where: 

1 Drum plotter, 

2 Table plotter, 

3 Storage tube display, and 

4 Microfilm device. 

Display surface extent in X direction in 
inches. 

Display surface extent in Y direction in 
inches. 

Number of pens. 

Is there hardware character generation? 
If no, code 0; 

If yes, code 1. 

Are there hardware generated dotted 
lines? 

If no, code 0; 

If yes, code 1. 

Are there hardware generated dashed 
lines ? 

If no, code 0; 

If yes, code 1. 

Is there hardware arc generation? 

If no, code 0; 

If yes, code 1. 

Is there hardware cubic generation? 

If no, code 0; 

If yes, code 1. 

Number of increments per inch (that is, 
100, 200, 400,...). 

Normal mode of operation where: 

0 Batch processing, and 
1 Interactive processing. 


The primary overlay then calls the working routine, 
NPFDATA, in the main overlay which transfers the above 
information into the appropriate variables and transfers 
control to the main processor. 


76071100 M 


11-13-3 



The main processing unit of the main overlay fills the 
PPREQ common area and returns to the working routine 
which returns to the primary overlay. 

Upon return to the primary overlay, PPREQ contains one 
of the following: 


VECTOR REQUEST (IREQ = 1) 

The vector request provides the arguments necessary for 
a call to the CalComp standard subroutine PLOT or its 
equivalent. A value of 999 in IPRM(3) indicates that the 
current request is the final request in the run, and buffers 
should be purged, files closed, etc., as required and the 
program ended. A dashed or dotted vector (IPRM(3) = 4 

to 5) is requested only if the presence of those features 
was indicated in the return from the initialization request. 

Code Definition 

FPRM(l) X - coordinate. 

FPRM(2) Y - coordinate. 

IPRM(3) Vector type where: 

2 Solid line, 

3 Invisible, 

4 Dashed line (only if hardware 
dashed lines are available), 

5 Dotted line (onfy if hardware 
dotted lines are 
available), 

-3 New picture, and 
999 End of run. 


NEWPEN REQUEST (IREQ = 2) 

A call to the CalComp standard subroutine NEWPEN or 
the equivalent is requested. 

IPRM(l) = pen number 

This request may be made for a single-pen plotter if the 
application creating the neutral picture file calls NEWPEN 
with a negative pen number. If IPRM(l) is negative on a 
single pen plotter the following calls should be made: 

CALL PLOT(0. 0,0. 0,999) 

CALL PLOTS(IBUF,ISIZE,Il’NIT) 


ALPHA STRING REQUEST (IREQ = 3) 

This request provides the overlay with the parameters 
needed for a character string call to the CalComp 
standard subroutine SYMBOL. l T p to 100 characters may 
be present in each request. The X and Y coordinates 
usually have values of 999. 0, indicating that the string is 
to be started at the current pen position. Centered 
symbols are not included in this type of request. 


Code 

Definition 

FPRM(l) 

X - coordinate of start of character 
string. 

FPRM (2) 

Y - coordinate of start of character 
string. 

FPRM(3) 

Character height. 

FPRM (4) 

Angle of baseline of character string 
in degrees. 

IPRM(5) 

IPRM(6) 

Number of characters. 

through 

IPRM(15) 

BCD character string. 


DEVICE MODE REQUEST (IREQ = 4) 

Arguments to device independent subroutines are passed 
unchanged through the neutral plot file. If the user of the 
post-processor selects the proper display device, a 
plotter mode request will be made to the overlay. The 
overlay should inspect IPRM(l) which will contain the 
name of the device specific routine in left-justified A10 
format, and then call the specified routine using the sub¬ 
sequent words of IPRM as the arguments (use FPRM if an 
argument is of type REAL). The words of the array are 
used in ascending order from left to right in the subroutine 
argument list. (See UNIPLOT Reference/User’s Guide 
for description of Device Mode Subroutine.) 


Code 

Definition 

IPRM(l) 

Name of subroutine. A10 format, 
left justified. 

1PRM(2) 

through 

IPRM(13) 

Subroutine arguments. 

FPRM (2) 
through 
FPRM (13) 

Subroutine arguments. 


REORIGIN REQUEST (IREQ = 5) 

This request is part of the overplot feature and is intended 
to be used by cathode-rav tube (CRT) displays only. When¬ 
ever a new drawing (reorigin) occurs in the neutral plot 
file, the overlay for a CRT display must decide whether or 
not to erase the current contents of the display. This de¬ 
cision is made by testing the overplot flag. 

Code Definition 

IPRM(l) Overplot flag where: 

0 Do not overplot: erase, and 

1 Overplot: do not erase. 
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INCREMENT REQUEST (IREQ = 6) 

This request passes the value of the plotter increment 
size, as input in an INCREMENT statement to the overlay. 
The overlay may, on the basis of this value, call FACTOR 
to adjust the size of the finished plot. If no INCREMENT 
statement has been processed, the value of the plotter 
increment will be the default increment as set by the de¬ 
vice dependent routines. If IREO-6, the variable con¬ 
taining the increments per inch should be modified ac¬ 
cordingly for any future initialization. 

FPRM(l) = plotter increment size (i.e., 01, . 005, 
or .0025) 


PEN RESTORE REQUEST (IREQ = 7) 

This request instructs the primary overlay to call the 
device dependent PLOT routine to move the pen to the 
bottom of the plotter as follows: 


CALL PLOT(0. 0,-30. 0,-3) 


After the primary overlay is built it can be added to the 
PL71 tape and a new absolute file cataloged by running the 
following EXTRACT job. 


EXTRACT, 


MTlj 
NTlj * 


ACCOUNT. (Supply valid ACCOUNT card.) 


LABEL(PL71,R, L-UNIPLOTV2, D= 
VSN-PL71) 

COPYBF(PL71, OLDPL) 
REWIND(OLDPL) 



UPDATE(O, *= =, C, D, 8) 


ROUTE (COMPILE, DC=IN) 
7/8/9 


=D ADD.XX 

ACCOUNT. (Change ACCOUNT card if 

appropriate.) 

=D ADD.XX (Delete the comment card and 

*IDENT DEV022 insert the updates to DEVLIST 
*D DEVLIST. XX and the new overlay deck. See 
the listing of DEVLIST from 
the installation run for sequence 
numbers.) 

INTEGER DEVICE(15) 


*AF 

*DECK OVL022 (Insert interface program and 

device dependent routines here.) 

6/7/8/9 

If it is not desired to update PL71, a new post-processor 
can be created from a user library device dependent 
routines by running the following job: 


ADDEV, 


r MTl 
NT1 * 


ACCOUNT. 


LABEL, PL71, R, L=IJNIPLOTV2, D- 
VSN=PL71. 

SKIPF, PL71, 3,17, B. 

COPYBF, PL7.1, OLDPL. 



UNLOAD(PL71) 

REWIND(OLDPL) 

UPDATE (O) 

ATTACH, UN 12, POSTLGO, ID-UNIPLOT. 
ATTACH, LIB1, DEVICE ROUTINES, ID=xxx. 


(Attach the device dependent 


routines.) 


FTN, I. 


FTN, B-OVL026. 


REWIND, LGO,OVL02G. 

C OP YL, UNI2, LG O, UN 12 A. 
REQUEST, UNIPOST, *PF. 
FILE(PLOTF, RT-S, BT=C) 
LDSET(FILES-P LOTF) 
LOAD(UNI2A) 
LOAD(OVL026) 

SATIS FY(LIBl) 

NOGO. 


CATALOG, UNIPOST, ID-UNIPLOT, PW=1. 
7/8/9 

*IDENT DEVxxx 


(Insert DEVLIST updates.) 

*COMPILE DEVLIST 
7/8/9 

(Insert primary overlay main 
program.) 

G/7/8/9 


VERIFICATION PROCEDURE 


The program, VERIFY, can be run to verify proper in¬ 
stallation of UNIPLOT as follows: 


(MTlj 
(NTlj 
ACCOUNT. 


VRFY, 


LABEL(PL71, R, L-UNIPLOTV2, D= 
VSN-PL71) 

SKIPF(PL74,4,17, B) 

COP YBF(PL71, OLDPL) 
UNLOAD(PL71) 

REWIND(OLDPL) 

UPDATE(F, *==,C,D, 8) 
ROUTE(COMPILE, DC-IN) 

7/8/9 
-IDENT xx 



=D VERIFY, xx (To change job and account 

ACCOUNT. card as needed.) 

=D VERIFY, xx. (To specify the device.) 

UNIPOST, D-de vice. 

6/7/8/9 


The run initiated by VRFY will create a 7-track tape ready 
for plotting on the specified device. 
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USAGE ACCOUNTING UTILITY 


14 


RELEASE DESCRIPTION 


The Usage Accounting Utility release tape (AP001B) for 
NOS/BE 1 consists of the following three files: 

File 1 - the installation deck PL containing the 
UAUINS job which installs the software necessary to 
provide accounting for usage priced software. 

File 2 - RANDR (Update/data reduction/report 
generation program) - this program reads user pre¬ 
pared input directive cards and performs the functions 
specified by the directives. The functions, all re¬ 
lating to the product file and the usage detail file are: 

1. Maintain product file data base. 

2. Reduce data on the usage detail file and pro¬ 
duce detail usage summary/billing reports 
as per directives. 

3. Generate system status reports. 

File 3 - ACOUNTX - (Usage pricing accounting 
module) - this set of subroutines provides the ac¬ 
counting interface to usage priced applications. 
ACOUNTX tracks application usage and logs that 
usage on the usage detail file. 

RANDR and ACOUNTX are to be installed on the SYSTEM 
library NUCLEUS and SYSLIB respectively. 

HARDWARE REQUIREMENTS 

RANDR can be maintained on the same minimum hardware 
configuration as NOS/BE 1. The amount of core over and 
above that required by the calling application depends upon 
whether or not the calling application uses the CYBER 
record manager (CRM), the common memory manager 
(CMM), and/or is written in FORTRAN Extended Version 4 
(FTN-4) (see Table II-14-1). 

TABLE II-14-1. ADDITIONAL CORE REQUIREMENTS 

Maximum Additional Core 

Application Characteristics Required for ACOUNTX 


CRM 

FTN-4 

CMM 

(In Octal) 

YES 

YES 

YES 

2.5K 

YES 

YES 

NO 

3. IK 

YES 

NO 

YES 

3.6K 

YES 

NO 

NO 

4.2K 

NO 

YES 

YES 

12.5K 

NO 

YES 

NO 

13. IK 

NO 

NO 

YES 

13. 6K 

NO 

NO 

NO 

14.2K 


CORRECTIONS 

There are no applicable PSR summaries. 

DEFICIENCIES 

It is imperative that at least one billing run be made in the 
month of January to prevent corruption of the year-to-date 
totals. 


Notes and Cautions 

When loading an application calling ACOUNTX, nonfatal 
load errors may occur due to duplicate system entry points. 
Other errors should be investigated. 


INSTALLATION PARAMETERS 

Upon installation (creation) of the two necessary files, the 
product file and the usage detail file, various protection 
parameters may be specified on the input card (ID=1) 
specifying UPDATE (see Usage Accounting Utility Reference 
Manual) . 

Column Contents 

1 to 4 CPU model code; this is a four-character 

code associated with the machine type and 
will not be changed after the files are 
established. (The codes are found in ap¬ 
pendix C of the Usage Accounting Utility 
Reference Manual. ) The customer, in the 
event of a CPU model upgrade (for example, 
a CYBER 172 with a 10316-1 upgrade is a 
CYBER 173), is obligated to perform a 
final billing run on the existing product 
and detail files, remove those files, and 
recreate them with the appropriate CPU 
model code. 

5 Blank, reserved. 

6 Threshold protection indicator; Y specifies 
that special usage accumulator entries will 
be built, updated, and maintained in the 
usage detail file; accumulators, thresholds 
and product status (active or inactive) are 
checked and/or updated at start and end of 
an application. N specifies no special 
threshold checking is to be done. 

Blank defaults to N. 
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Column 


Contents 


Column 


Contents 


This parameter may be changed at any 
time. However, altering it from Y to N 
and vice versa between billing runs cor¬ 
rupts the effectiveness of threshold 
protection. 

The special usage accumulator entries con¬ 
tain a usage accumulator. During a billing 
run, which covers a period of at least one 
full month, the accumulator is decre¬ 
mented by the invoiced amount of usage. 

The special usage accumulator entries are 
lost when a billing run is made with the 
threshold protection installed as N. They 
can be reestablished (initialized) via an 
UPDATE run with threshold protection 
set to Y. 

NOTE 

Threshold protection is merely to 
assist the site in limiting their 
usage and is not intended in any 
way to limit the sites T liability 
for usage as reported in monthly 
billing runs. 

7 to 9 Blank, re served. 

10 to 14 Right-justified number (blanks treated as 

zero). It is multiplied by 1000 and repre¬ 
sents the size (in number of words) at 
which the operator is warned that the de¬ 
tail file size protect has been reached. 

No other action is performed. It is the 
site responsibility to make a billing run 
(see Usage Accounting Utility Reference 
Manual) to reduce and report the usage 
detail file. 

This parameter may be changed at any 
time. 

15 Blank, reserved. 

16 User number field protection; Y specifies 
that the user number will be blanked on 
all detail usage reports. 

N specifies that user numbers for each ac¬ 
counting job step will appear on the detail 
usage reports. 

Blank defaults to N. 

This parameter may be changed at any 
time. 

The following information represents directives to RANDR 
and is not considered installation parameters. 


17 

Blank, reserved. 

18 

1; represents parameter type card. 

19 

1 to 9; represents number of copies of 
report. 

20 to 25 

UPDATE 

26 to 80 

Blank, reserved. 


NOTE 


After installation creation, any of 
the above installation parameters 
may be changed except the CPU 
model code without removing and 
recreating files. 

Also upon installation (creation) of the two necessary files 
(product and usage detail), a Control Data regional address 
must be installed. The Control Data address to be used is 
specified on the front of the software contract. In addition, 
the customer is obligated to supply their address and the 
name of an individual as a primary contact for resolution 
of any matters which may arise pertaining to the prepara¬ 
tion, content and submission of the usage reports. The 
address information is specified on the input cards HI) 2,.'b 
to the creation run and may be altered in part or whole bv 
update runs. 

For each specific usage priced product, there is additional 
installation information to be specified on the product ac¬ 
tivity card (ID 4); vendor code, product name, transaction 
codes, threshold protection values, and software codes. 

The vendor code, product name, and software code for 
Control Data usage priced products are supplied with the 
installation information; see specific application product 
description in this manual. Threshold protection values 
are supplied by the site. 

(For further description of the input card types, see the 
Usage Accounting Utility Reference Manual.) 


INSTALLATION PROCEDURE 


AP001N contains the usage accounting utility. The RANDR 
and ACOUNTX modules are SYSEDIT’ed into the running 
system. 

The following job is used to retrieve the installation job 
UAUINS from AP001B. This deck is not available on the 
INSTALLDECK,ID=IDECKS files. 
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UAUID(CM50000, T100, MT01) FOR 7-TRACK. 

HD01 OR PE01 FOR 9-TRACK. 

COMMENT. REPLACE THIS CARD WITH LOCAL 
ACCOUNTING INFORMATION 
COMMENT. THIS JOB ROUTES A JOB TO INSTALL 
COMMENT. THE USAGE ACCOUNTING UTILITY 
COMMENT. INTO THE RUNNING SVSTEM 
COMMENT. **XX=HY 7-TRACK (800 bpi), 

HD/9-TRACK (800 opi) OR PE/9-TRACK (1600 cpi) 
REQUEST(COMPILE, *Q) 

LABEL(UAUTIL, D=XX,R, VSN=AP001B, 

L=USAGE AC C TNG 1P0) 

UPDATE(P=UAUTIL, *= =) 

ROUTE (COMPILE, DC=IN) 

7/8/9 - EOR - 
UPDATE DIRECTIVES 

THE UPDATE DIRECTIVES VARY 
DEPENDING UPON THE DENSITY 
AND TRACK TYPE BEING USED. 
=DEFINE MTHY - 7 TRACK, 800 bpi 
=DEFINE NTHD - 9 TRACK, 800 cpi 
=DEFINE NTPE - 9 TRACK, 1600 cpi 

6/7/8/9 - EOI - 

The usage accounting utility is installed on the running 
system from AP001B by running job UAUINS which is 
executed by the above job UAUID. Refer to the section on 
"Installation Job" for a listing of UAUINS. 


INSTALLATION JOB 


RANDR establishes the product file and the usage detail 
file. If usage accounting files do not exist under ACXLIB, 
the applications interface ACOUNTX will not run. 

UAUINS is the job which installs the usage accounting 
utility binaries on the running system. 

UAUINS,CM50000,T100,MT1. FOR 7-TRACK. 

HD1 OR PEI FOR 9-TRACK. 

COMMENT. (Replace this card with local ac- 
COMMENT. counting information. This job will 

COMMENT. EDITLIB the usage accounting 

COMMENT. utility binaries into the running 

COMMENT. system.) 

COMMENT. **XX=HY/7-TRACK (800 bpi), 

HD/9-TRACK (800 cpi) OR PE/9-TRACK (1600 cpi) 
LABEL(UAUTIL, D=XX, R, VSN=AP001B, 
L=USAGEACCTNG1P0) 

REWIND(UAUTIL) 

SKIPF(UAUTIL, 1,17) 

COP YBF(UAUTIL, RANDR ,1,17) 

COP YBF(UAUTIL, ACOUNTX, 1,17) 

REWIND (RANDR, ACOUNTX) 

EDITLIB(SYSTEM) 

7/8/9 - EOR - 
READY (SYSTEM, OLD) 

LIBRAR Y(NUCLEUS, OLD) 

REPLACED, RANDR, AL=0) 

SETFL(RANDR, 70000) 

SETAL(RANDR,1) 

FINISH. 


LIBRAR Y(SYSLIB, OLD) 

REPLACED, ACOUNTX, AL=0) 

FINISH. 

LISTLIB(*, SYSTEM, NUCLEUS) 

LISTLIB(*, SYSTEM, SYSLIB) 

COMPLETE. 

ENDRUN. 

6/7/8/9 - EOI - 

Once the RANDR and ACOUNTX modules are installed on 
the running system, a new deads tart tape of the running 
system should be created. 

Prior to execution of any usage priced applications, the 
following job UAFINS must be run. This job establishes the 
product file, initializes the usage detail file, and creates 
the product file entries for the leased Control Data usage 
priced application^). 

UAFINS(CM74000, T100) 

COMMENT. (Replace this card with local account¬ 
ing information.) 

COMMENT. (This job establishes the product file 
COMMENT. and initializes the usage detail file.) 
RANDR. 

7/8/9 - EOR - (The data deck’s contents vary de¬ 
pending upon the application^) being 
installed. For this initial run there 
UPDATE must be 1 (ID=1) parameter card, 

DATA CARDS 3 (ID=3) CDC address cards and at 
least 1 (ID=4) product card. See 
Usage Accounting Utility Reference 
Manual. ) 

6/7/8/9 - EOI - 


PRODUCT AND USAGE DETAIL FILE 


The product file is maintained as a permanent file and is 
catalogued as follows: 

pfn - AUAPTF 
ID - JJFWGR 
CY - 1 
RP - 999 
TK -SURPTK 
RD -SURPRD 
EX -SURPEX 
MD - SURPMD 
CN -SURPCN 

The usage detail file is also maintained as a permanent 
file and is catalogued as follows: 

pfn - AUADTF 
ID - JJFWGR 
RP - 999 
TK -SURPTK 
RD -SURPRD 
EX -SURPEX 
MD - SURPMD 
CN -SURPCN 
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Because of the importance of these files, every attempt has 
been made to ensure that they are not lost during a RANDR 
run due to some external job interruption. 

During a RANDR run, two other permanent file names 
become associated with AUAPTF (PFNEW, PFTMP) 
and AUADTF (DFNEW, DFTMP). The passwords, etc. , 
are the same. Completion of RANDR purges these working 
files; noncompletion of RANDR (e.g., parity error, system 
abort, unexpected operator intervention) may cause them 
to be left as part of the permanent file base. 

As RANDR modifies product file entries, the file (AUAPTF) 
is being rewritten as PFNEW. DFNEW has multiple uses. 
PFTMP is the AUAPTF file renamed and represents the 


product file prior to the RANDR run. Likewise, DFTMP 
represents the AUADTF file prior to the RANDR run. 

In the event of an external job interruption, the recom¬ 
mended recovery procedure is to purge all files except the 
PFTMP and DFTMP files, RENAME then as AUAPTF and 
AUADTF, respectively, and rerun RANDR. In the event 
that one or both of the xxTMP file(s) are not found, but 
the xxNEW file(s) are present no action is necessary other 
than to purge the xxNEW file(s) and rerun RANDR. 

It is further recommended that the site maintain adequate 
back up for these files (AUAPTF, AUADTF) through their 
DUMPF utility. 
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INTRODUCTION 
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INSTALLATION, MODIFICATION AND USER RELATED DOCUMENTATION 

EXECUTION 


Part III presents information pertaining to the installation 
of applications software under SCOPE 2.1. However, 
users must also reference the SCOPE 2.1 Installation 
Handbook for appropriate systems information that governs 
installation and execution dependencies, mandatory instal¬ 
lation sequences and the inclusion of modifications (see 
part I, section 3 and part II, section 1 for specific details). 


The following manuals pertain to SCOPE 2.1 and to 
appropriate applications products described in part III. 

Title Publication No. 

SCOPE 2.1 Installation Handbook 60426100 

SCOPE 2.1 Reference Manual 60342600 


Control Data assumes that the installation of applications 
software will be performed by an analyst having at least 
six months experience with a Control Data 7600 or CYBER 
70 computer system. These products are intended to be 
installed and maintained onty as described in this manual 
and the accompanying SCOPE 2.1 Installation Handbook. 

As a result Control Data is only responsible for the proper 
functioning of features or parameters described in these 
two publications. 


APEX III Reference Manual 

APT IV Internal Maintenance 
Specification 

APT IV Reference Manual 

IMSL Reference Manual, Vols. I - II 

SIMSCRIPT I. 5 Reference Manual 
Version 3 


76070000 

t 

17326900 

SMD150043t 

97400200 


RELEASE MATERIALS 


Application 


Tape Chapter 


APEX III Out-Of-Core 
System 1 

APEX III Mixed Integer 
Programming Option 
(MIP) 

APEX III Matrix Reduction 
Option (REDUCE) 

APEX III Parametrics 
Option 
APT IV 2 
IMSL 6 

SIMSCRIPT 1.5 3 


A3CREL 

MIPREL 


REDREL 

PARREL 

PL59 

IMSLREL 

SIMREL 


2 

2 

2 

2 

3 

4 

5 


t The APT IV Version 2. 0 Internal Maintenance Specifications may only be ordered by title through Control Data 
Corporation, Software Manufacturing and Distribution, 4201 North Lexington Avenue, St. Paul, Minnesota 55112. 
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APEX-III PRODUCT OPTIONS 


2 


APEX-III consists of a number of product options, each of 
which is separately priced and ordered. 


APEX-III OUT-OF-CORE SYSTEM 1 


RELEASE DESCRIPTION 

APEX-III Out-of-Core System 1 runs under the SCOPE 2.1 
operating system. The FORTRAN Extended compiler is 
required for compiling and updating APEX-III. APEX-III 
Out-of-Core System 1 is designed to execute from 
permanent files. 


LIST, T20, 


|NT1 

|MT1 


, STGGG. 


ACCOUNT. 

LABEL(OLDPL, LOOCAPEXIIIV1P1) 


STAGE(OLDPL, PRE, 



, E, VSN=A PXOOC) 


COPYBF(OLDPL, OLD) 
UPDATE(F, *= =, L=7, P=OLD) 
SKIPF(OLDPL, 3,17) 

UPDATE(F, *= -, L-7, R) 

7/8/9 

6/7/B/9 


Hardware Requirements 

APEX-III Out-of-Core System 1 requires the same mini¬ 
mum hardware configuration as SCOPE 2.1. A minimum 
field length of 6OK octal is required to compile and execute 
APEX-III. 


Deficiencies 

None. 


RELEASE MATERIALS 

APEX-III Out-of-Core System 1 resides on the tape known 
as A3CREL. A3CREL is a 7- or 9-track tape with the 
following characteristics: labeled, 800 bpi, odd parity, 
BT=I, RT=W, MBL-5120. OOCAPEXIIIV1P1 is the file 
identifier in the HDR1 label. 

Partition 1 - installation deck in UPDATE PL form, 
Partition 2 - empty, 

Partition 3 - empty, 

Partition 4 - source code in UPDATE PL form, 

Partition 5 - verification deck in UPDATE PL form, 
and 

Partition 6 - sample output from verification run. 

Listings of the installation deck (APEXC1) and the verifica¬ 
tion deck (APEXCV) may be obtained from tape A3CREL by 
executing the following job: 


INSTALLATION PARAMETERS 

None. 


INSTALLATION PROCEDURES 

APEX-III Out-of-Core System 1 is installed by executing 
deck APEXC1, contained on the first file of tape A3CREL. 
This job deck reads the APEX-III system from A3CREL, 
compiles the system, and installs an executable file of the 
APEX-III system on a permanent file named APEXIII with 
ID=APEX. 

This job deck also creates three permanent files which are 
needed when one uses the APEX-III USER feature. (Refer¬ 
ence the APEX-III Reference Manual for detailed informa¬ 
tion.) For those installations where the USER feature is 
used infrequently, it may be desirable to maintain these 
three files on magnetic tape rather than permanent files. 
These three files are described below: 


Name 

ID 

Contents 

APEXPL 

APEX 

Partial APEX-III source code. Con¬ 
tains APEX-III COMMON regions 
and subroutines QBUFFER, QGET, 
QUSER, and QUSERDA. 

APEXOV 

APEX 

Relocatable binary code of APEX-III 
overlay drivers. 

APEXRL 

APEX 

Relocatable binary code of remaining 
APEX-III subroutines. 


For those installations which have purchased any of the 
APEX-III options, deck APEXC1 may also be used to install 
the APEX-III Out-of-Core System 1 with any combination 
of the APEX-III Mixed Integer Programming Option, 
APEX-III Matrix Reduction Option, and APEX-III Parame- 
trics Option. 
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The deck APEXC1 contains UPDATE IF, DEF directives 
to simplify installation. The names used by these direc¬ 
tives and their meaning when DEFINEd are as follows: 

Name Effect on Installation Job 

NT Uses 9-track magnetic tapes. 

MT Uses 7-track magnetic tapes. 

MIP APEX-III Mixed Integer Programming Option 

is installed with APEX-III Out-of-Core 
System 1. 

RED APEX-III Matrix Reduction Option is installed 

with APEX-III Out-of-Core System 1. 

PAR APEX-III Parametrics Option is installed with 

APEX-III Out-of-Core System 1. 

Deck APEXC1 can be retrieved from tape A3CREL through 
the following procedure: 


(nti) 

EXTR, T20, | MT1 ,STGGG. 

ACCOUNT. 

LABEL(OLDPL, LOOCAPEXIIIV1P1) 

STAGE(OLDPL, PRE, |™} . E, VSN =APXOOC) 
UPDATE(F, *= =, C=PUNCH, D, 8) 

COMMENT. * INSTALLATION DECKS ON PUNCH** 
7/8/9 

=DEFINE FB 
(MT| 

=DEFINE MIP (If Matrix Integer Programming 

Option.) 

=DEFINE RED (If Matrix Reduction Option.) 

=DEFINE PAR (If Parametrics Option.) 

=D, APEXC1.2, APEXC1.3 
( NTI) 

INST, T2000, ,STGGG (Supply valid JOB card.) 

ACCOUNT. (Supply valid ACCOUNT card.) 

=C,APEXC1 

7/8/9 

6/7/8/9 


EXTV, T20, 


(NTI) 

MT1 


, STGGG. 


ACCOUNT. 

LABEL(OLDPL, L=OOCAPEXIIIVlPl) 
(HD 


STAGE (OLDPL, PRE, 


HY 


, E, VSN=A PXOOC) 


SKIPF(OLDPL,4,17) 

UPDATE(F, *= = , C=PUNCH,D, 8,R) 

COMMENT. **VERIFICATION DECK ON PUNCH** 
7/8/9 

=D, APEXCV. 2, APEXCV. 3 

VER,T50,STGGG. (Supply valid JOB card.) 

ACCOUNT. (Supply valid ACCOUNT card.) 

=C, APEXCV 

7/8/9 

6/7/8/9 


Partition 6 of tape A3CREL can be copied to OUTPUT and 
used to validate correct execution of the verification run. 


APEX-III MIXED INTEGER PROGRAMMING 
OPTION (MIP) 

RELEASE DESCRIPTION 

The APEX-III Mixed Integer Programming Option runs 
under the SCOPE 2.1 operating system when installed with 
APEX-III Out-of-Core System 1. The FORTRAN Extended 
compiler is required for compiling APEX-III MIP. 
APEX-III is designed to execute from permanent files. 


Hardware Requirements 

APEX-III MIP requires the same minimum hardware con¬ 
figuration as SCOPE 2.1. A minimum field length of 60K 
octal is required to compile and execute APEX-III MIP. 


Deficiencies 

None. 


Error Messages 

A nonfatal loader error will be encountered in loading the 
APEX-III system. The error message is of the form: 

EXIT DUPLICATE ENTRY POINT IGNORED 

Errors of any other form should be investigated. 


RELEASE MATERIALS 

The APEX-III Mixed Integer Programming Option resides 
on the tape known as MIPREL. MIPREL is a 7- or 9-track 
tape with the following characteristics: labeled, 800 bpi, 
odd parity, BT=I, RT=W, MBL=5120. MIPAPEXIIIV1P1 
is the file identifier in the HDR1 label. 


INSTALLATION VERIFICATION 

The verification deck, APEXCV, can be retrieved from 
tape A3CREL through the following procedure: 
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Partition 1 - installation deck in UPDATE PL form. 
Partition 2 - empty. 

Partition 3 - empty, 

Partition 4 - source code in UPDATE PL form. 

Partition 5 - verification deck in UPDATE PL form, 
and 

Partition 6 - sample output from verification run. 


Listings of the installation deck (APEXC1) and the verifi¬ 
cation deck (APEXMV) may be obtained from tape MIPREL 
by executing the following job: 


NTll 

MT1 


LIST, T20, ,STGGG. 

ACCOUNT. 

LABEL(OLDPL, L-MIPAPEXIIIV1P1) 
(HD) 


STAGE(OLDPL, PRE, 


HYj 


, E, VSN=APXMIP) 


COPYBF(OLDPL, OLD) 
UPDATE(F, *= =, L=7, P=OLD) 
SKIPF(OLDPL, 3,17) 

UPDATE(F, *= =, L=7, R) 

7/8/9 
6/7/8/9 


(NTl) 

EXTV, T20, j MT1 J , STGGG. 

ACCOUNT. 

LABEL(OLDPL, L=MIPAPEXIIIV1P1) 

STAGE(OLDPL, PRE, (™) , E, VSN=APXMIP) 


SKIPF(OLDPL, 4,17) 

UPDATE(F, *==, C~PUNCI1, D, 8,R) 

COMMENT. **VERIFICATION DECK ON PUNCH** 
7/8/9 

=D, APEXMV. 2, APEXMV. 3 

VER,T50,STGGG. (Supply valid job card.) 

ACCOUNT. (Supply valid ACCOUNT card.) 

=C, APEXMV 

7/8/9 

C/7/8/9 


Partition 6 of tape MIPREL can be copied to OUTPUT and 
used to validate correct execution of the verification run. 


APEX-III MATRIX REDUCTION OPTION 
(REDUCE) 


RELEASE DESCRIPTION 


INSTALLATION PARAMETERS 

None. 


INSTALLATION PROCEDURES 


The APEX-III Matrix Reduction Option runs under the 
SCOPE 2.1 operating system when installed with APEX-III 
Out-of-Core System 1. The FORTRAN Extended compiler 
is required for compiling and updating APEX-III REDUCE. 
APEX-III REDUCE is designed to execute from permanent 
files. 


The APEX-III Mixed Integer Programming Option must be 
installed with APEX-III Out-of-Core System 1. The in¬ 
stallation deck, APEXC1, on MIPREL is identical to the 
installation deck for APEX-III Out-of-Core System 1. 

The name MIP is defined for the UPDATE IF,DEF direc¬ 
tives in deck APEXC1 to merge the MIP Option with the 
out-of-core system. 

Reference "Installation Procedure" for APEX-III Out-of- 
Core System 1 for details of installation and expected error 
messages. 


Hardware Requirements 

APEX-III REDUCE requires the same minimum hardware 
configuration as SCOPE 2.1. A minimum field length of 
6OK octal is required to compile and execute APEX-III. 

Deficiencies 

None. 


INSTALLATION VERIFICATION 

The verification deck, APEXMV, can be retrieved from 
tape MIPREL through the following procedure: 
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RELEASE MATERIALS 

The APEX-III Matrix Reduction Option resides on the tape 
known as REDREL. REDREL is a 7- or 9-track tape with 
the following characteristics: labeled, 800 bpi, odd parity, 
BT=T, RT=W, MBL=5120. REDAPEXIIIV1P1 is the file 
identifier in the HDR1 label. 

Partition 1 - installation deck in UPDATE PL form, 
Partition 2 - empty, 

Partition 3 - empty, 

Partition 4 - source code in UPDATE PL form. 

Partition 5 - verification deck in UPDATE PL form, 
and 

Partition 6 - sample output from verification run. 

Listings of the installation deck (APEXC1) and the verifi¬ 
cation deck (APEXRV) may be obtained from tape REDREL 
by executing the following job: 

LIST.T20, PZM ,STGGG. 

’ (MTl) 

ACCOUNT. 

LABEL(OLDPL, L=REDAPEXIIIV1P1) 

STAGE(OLDPL, PRE, j™ 

COPYBF(OLDPL, OLD) 

UPDATE (F, *= =, L=7, P=OLD) 

SKIPF(OLDPL,3,17) 

UPDATE(F, *= =, L=7,R) 

7/8/9 
6/7/8/9 


INSTALLATION PARAMETERS 

None. 


INSTALLATION PROCEDURES 

The APEX-III Matrix Reduction Option must be installed 
with APEX-III Out-of-Core System 1. The installation 
deck, APEXC1, on REDREL is identical to the installation 
deck for APEX-III Out-of-Core System 1. The name RED 
is defined for the UPDATE IF,DEF directives in deck 
APEXC1 to merge the REDUCE Option with the Out-of- 
Core System. 

(Reference "Installation Procedure" for APEX-III Out-of- 
Core System 1 for details of installation and expected 
error messages.) 


EXTV, T20, 1^”] , STGGG. 

ACCOUNT. 

LABEL(OLDPL, L=REDAPEXIIIV1P1) 

STAGE(OLDPL, PRE, |™J ,E, VSN=APXRED) 

SKIPF(OLDPL,4,17) 

UPDATE(F, *==, C=PUNCH, D, 8,R) 

COMMENT. **VERIFICATION DECK ON PUNCH** 
7/8/9 

=D, APEXRV. 2, APEXRV. 3 

VER.T50, STGGG. (Supply valid JOB card.) 

ACCOUNT. (Supply valid ACCOUNT card.) 

=C,APEXRV 

7/8/9 

G/7/8/9 

Partition 6 of tape REDREL can be copied to OUTPUT and 
used to validate correct execution of the verification run. 


APEX-III PARAMETRICS OPTION 


RELEASE DESCRIPTION 

The APEX-III Parametries Option runs under the SCOPE 
2.1 operating system when installed with APEX-III Out- 
of-Core System 1. The FORTRAN Extended compiler is 
required for compiling and updating APEX-III Parametrics. 
APEX-III Parametrics is designed to execute from perma¬ 
nent files. 


Hardware Requirements 

APEX-III Parametrics requires the same minimum hard¬ 
ware configuration as SCOPE 2.1. A minimum field length 
of 60K octal is required to compile and execute APEX-III. 


Deficiencies 

None. 


RELEASE MATERIALS 

The APEX-III Parametrics Option resides on the tape 
known as PARREL. PARREL is a 7- or 9-track tape with 
the following characteristics: labeled, 800 bpi, odd parity, 
BT=I, RT=W, MBL=5120. PARAPEXIIIV1P1 is the file 
identifier in the HDR1 label. 


, E, VSN=APXRED) 


Installation Verification 

The verification deck, APEXRV, can be retrieved from 
tape REDREL through the following procedure: 


it 
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Partition 1 - installation deck in UPDATE PL form, 
Partition 2 - empty, 

Partition 3 - empty, 

Partition 4 - source code in UPDATE PL form, 

Partition 5 - verification deck in UPDATE PL form, 
and 

Partition 6 - sample output from verification run. 


APEXC1, on PARREL is identical to the installation deck 
for APEX-III Out-of-Core System 1. The name PAR is 
defined for the UPDATE IF,DEF directives in deck 
APEXC1 to merge the Parametrics Option with the Out-of- 
Core System. 

(Reference "Installation Procedure" for APEX-III Out-of- 
Core System 1 for details of installation and expected 
error messages.) 


Listings of the installation deck (APEXC1) and the verifi¬ 
cation deck (APEXPV) may be obtained from tape PARREL 
by executing the following job: 


LIST, T20, 


[NTlj 

iMTlj 


.STGGG. 


ACCOUNT. 

LABEL(OLDPL, L=PARAPEXIIIV1P1) 
(HD 


STAGE(OLDPL, PRE, 


HY 


,E,VSN=APXPAR) 


COPYBF(OLDPL, OLD) 
UPDATE(F, *= =, L=7, P=OLD) 
SKIPF(OLDPL, 3,17) 

UPDATE(F, *= =, L=7, R) 

7/8/9 
6/7/8/9 


INSTALLATION PARAMETERS 


None. 


INSTALLATION VERIFICATION 


The verification deck, APEXPV, can be retrieved from 
tape PARREL through the following procedure: 


EXTV, T20, j/J/J ,STGGG. 

ACCOUNT. 

LABEL(OLDPL, L=PARAPEXIIIV1P1) 

STAGE (OLDPL, PRE, (™| ,E,VSN=APXPAR) 


SKIPF(OLDPL, 4,17) 

UPDATE (F, *= ~, C=PUNCH, D, 8,R) 

COMMENT. * VERIFICATION DECK ON PUNCH** 
7/8/9 

=D, APEXPV. 2, APEXPV. 3 

VER,T50,STGGG. (Supply valid JOB card.) 

ACCOUNT. (Supply valid ACCOUNT card.) 

=C,APEXPV 

7/8/9 

G/7/8/9 


INSTALLATION PROCEDURES 

The APEX-III Parametrics Option must be installed with 
APEX-III Out-of-Core System 1. The installation deck, 


Partition 6 of tape PARREL can be copied to OUTPUT and 
used to validate correct execution of the verification run. 
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APT IV 2 


3 


GENERAL DESCRIPTION 


INSTALLATION REQUIREMENTS 


APT IV is a numerical control language processor designed 
to generate cutter location coordinates. The user has the 
capability to fully describe the part to be machined and 
then drive the tool along the chosen path. The output from 
APT IV is a verification listing and a file for input to a 
post processor. APT IV V2 has all the capabilities of 
APT IV VI in addition to new language features and 
extensions. 

APT IV V2 runs under the SCOPE 2.1 operating system on 
a Control Data host computer having at least 65,000 words 
of central memory. 

RELEASE MATERIALS 


APT IV V2 for SCOPE 2.1 is contained on release tape 
PL59. The structure of PL59 is as follows: 

File 1 - contains the source library in UPDATE 
format. The first 49 decks, TAPE OP through 
ZDDPLIN are common decks called by one or more 
of the succeeding decks. The next 16 decks, LLDM 
through LBCDBIN, are the LOAD COMPLEX. The 
next deck, LLCDATA, is data used by the LOAD 
COMPLEX routines. The next 92 decks, TAPT4T 
through TLCANON, are the TRANSLATOR. The next 
333 decks, XAPT4E through ZZDDPICT are the 
EXECUTION COMPLEX. The next 45 decks, CAPT4C 
through CTAPEWT are the CLEDITOR. The last 18 
decks, PAPT4P through PTAPEWT are the POST 
EXEC. 

File 2 - contains the relocatable binary records of all 
routines needed for the STANDARD mode. It in¬ 
cludes the binary records, COD4, PRD4, PTR4, 

P004, and C004, produced by the LOAD COMPLEX. 
This file is ready to be loaded by the host computer 
system and will produce the absolute modules con¬ 
tained on file 3. 

File 3 - contains the absolute modules of the APT IV 
V2 system. The file should be placed on the system 
library if the user does not wish to modify the APT 
IV V2 processor. File 2 of the release tape is used 
to make file 3. 

File 4 - contains the decks to install APT IV V2 on 
the host computer system. 

File 5 - contains three identical part programs. Job 
control cards are provided to verify correct opera¬ 
tion with system overlays resident in the system 
library, permanent files, or user library. 


The system has four general modes of operation: 

1. Standard mode - offers all capabilities except 
parametric and sculptured surfaces. This mode 
requires approximately 110,000g words of field 
length to build the system and for execution; 

2. Parametric surface mode - offers all capabilities 
of the standard system plus the added features of 
parametric surface processing. This mode does 
not include sculptured surface processing. Ap¬ 
proximately 110,000g words are required to build 
the system and (110, 000g plus the length of the 
FORTRAN parametric surface routines) words for 
execution; 

3. Sculptured surfaces mode - offers all capabilities 
of the standard system plus the added features of 
sculptured surface processing. This mode does 
not include parametric surface processing. Ap¬ 
proximately 122,000g words are required to build 
and execute the system; 

4. Parametric and sculptured mode - both parametric 
and sculptured surface processing may be used. 
Approximately 122,000g words are required to 
build the system and (122, 000 g plus the length of 

of the FORTRAN parametric surface routine) words 
for execution. 


INSTALLATION OPTIONS 

The user may choose one of four modes: 

1. standard 

2. parametric surface 

3. sculptured surface 

4. parametric and sculptured surface 

The release system operates in Standard mode. 

In addition to the above modes, the user may choose one 
of three residences for the APT IV system. These are: 

1. system library 

2. permanent files 

3. user library 

The released system operates from the system library. 
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INSTALLATION PROCEDURES 


The following control cards may be used to obtain the verifi¬ 
cation and installation decks from PL59: 

IBGET, MT1 

LA BE L(G ET, R, L=A PT4 *R ELEASE) 
where RELEASE = SCOPE2P1 

SKIPF(GET, 3,17) 

COPYCF(GET, PUNCH, 2) 

6/7/8/9 

The following provides a description of all the installation 
decks included in file 4. The job name (MAPT41 - 
MAPT46) identifies the deck. 

• Install APT IV from file 3 of the release tape. 

Deck MAPT41 installs APT IV into the host 
computer operating system from file 3 of the re¬ 
lease tape. The first two files are skipped and 
the absolute modules of file 3 are copied to input 
files for the system library program. 

• Install APT IV from file 2 of the release tape. 

Deck MAPT42 may be used to make modifications 
to any routines except the LOAD COMPLEX. The 
modified routines are exchanged with their counter¬ 
parts on the supplied relocatable file, and the 
resultant file is installed on the host computer 
system. 

• Install APT IV from file 1 of the release tape. 

Deck MAPT43 and MAPT44 may be used to build 
the entire APT IV system from the source file. 

This will be necessary if the user wishes to install 
the sculptured surface and/or parametric surface 
mode of operation. The LOAD COMPLEX routines 
are compiled and executed. The output from 
LOAD COMPLEX is five FORTRAN block data 
programs which are then compiled and the relo¬ 
catable binaries are placed on the file LCBIN. 

The entire APT IV system (TAPT4T through 
PTAPEWT) is compiled and relocatable binaries 
are placed on APT BIN. The two files are merged 
to form the file APTLGO. This file is then input 
to the LOADER and the absolute overlay modules 
are placed in the overlay file APTOVL. The re¬ 
mainder of the control cards makes a new system 
release tape which may be used as input to deck 
MAPT41. 


INSTALLATION OPTIONS 


The user has the following two options: 

1. The user must insert an UPDATE directive card 
*DE FINE SSSURF to cause the sculptured surface 
routines to be compiled into the system. This 
card is present in deck MAPT43. 


2. The user must insert an UPDATE directive 

card *DEFINE PARSURF to cause the parametric 
surface routines to be compiled into the system. 
This card is present in deck MAPT44. 

Install APT IV from file 2 with overlay residence on 
permanent files. 

Deck MAPT45 may be used to modify the relocatable file 
so that the APT IV system overlays can reside on perma¬ 
nent files. This deck can be modified as noted with 
COMMENT cards for a relocatable file with or without 
sculptured surfaces defined. For purposes of this example, 
the standard and parametric modes are equivalent. 

The permanent files are defined, UPDATE is run with the 
overlay load parameter in deck TSUPERVT set equal to 0, 
the routine BEGINT is compiled and replaced on the re¬ 
locatable file. Each overlay deck is compiled so that the 
overlay will be placed on a separate file. The loader then 
produces absolute overlay modules on the permanent files 
which are saved for later use. 

Install APT IV from file 2 with overlay residence on a 
user library. 

Deck MAPT46 may be used to modify the relocatable file 
so that the APT IV system overlays can reside on a user 
library. The deck can be modified as noted with COMMENT 
cards for a relocatable file with or without sculptured 
surfaces defined. For purposes of this discussion, the 
standard and parametric modes are equivalent. 

UPDATE is run with the overlay load parameter in deck 
TSUPERVT set equal to 7LAPT40VL. The routine 
BEGINT is compiled and replaced on the relocatable file. 
The loader then produces absolute overlay modules on the 
file AFTOVL which is used as input to the EDITLIB pro¬ 
gram. EDITLIB then creates a user library on file 
APT40VL. 

Install APT IV from file 2 with overlay residence on the 
system library. 

Deck MAPT42 may be used to install the system overlays 
since the release file has the overlay load parameter in 
deck TSUPERVT set equal to 6LSYSTEM. 


LOAD COMPLEX EXECUTION 


Deck MAPT47 may be used to modify the five relocatable 
decks produced by the LOAD COMPLEX. The names of 
the decks are COD4, PRD4, PTR4, P004, and G004. 
Once the user modifications are determined and inserted, 
deck MAPT47 compiles and executes LOAD COMPLEX 
routines LLDM through LBCDBIN. 

The deck LCCDATA, which has been modified by the user, 
is the input data for the LOAD COMPLEX execution. The 
output, five FORTRAN BLOCK DATA routines, is then 
compiled and the relocatable decks replace their counter¬ 
parts on file 2 of the system release tape. Deck MAPT42 
may then be used to install the system. 
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VERIFICATION 


installed. Deck MAPT48 is used when the system over¬ 
lays reside on the host computer system library. Deck 
MAPT49 is used when the system overlays reside on 
Deck MAPT48, MAPT49, or MAPT50 from file 5 should permanent files. Deck MAPT50 is used when the system 

be used to verify that APT IV V2 has been correctly overlays reside on a user library. 
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RELEASE DESCRIPTION 


IMSL 6 (International Mathematical and Statistical Library, 
Version 6) consists of more than 400 FORTRAN functions 
and subprograms. IMSL 6 is on IMSLREL. 


HARDWARE REQUIREMENTS 

IMSL 6 requires the minimum hardware configuration for 
SCOPE 2. 


NOTES AND CAUTIONS 

The installation process does not provide program listings. 
If a program listing is needed (it is very long), the FTN 
card in the install deck may be appropriately modified 
(remove L=0). 


RELEASE MATERIALS 


IMSL 6 is contained on the tape known as IMSLREL. 
IMSLREL is a program library in UPDATE format. It 
has the following characteristics: 7-track (800 bpi) or 
9-track (800 or 1600 cpi), binary recording mode, seven 
files: 

File 1 - install deck in UPDATE OLDPL format, 

File 2 - empty file, 

File 3 - empty file, 

File 4 - program deck in UPDATE OLDPL format, 

File 5 - verify job control language deck in UPDATE 
OLDPL format, 

File 6 - expected verify output ((COPYBF, OUTPUT) 
format), and 

File 7 - verify program deck in UPDATE OLDPL 
format. 


INSTALLATION PROCEDURES 

The procedures for the installation of IMSL 6 are outlined 
in the following four steps: 


Step 1. Generate Essent ial Listings 
This step includes: 

• Installation deck, 

• Verification deck, and 

• Expected verify output. 

JOB. I 

ACCOUNT(*, *, *, *) } (Supplied by user.) 
FILE(TAPE,RT=S) 

LABEL(TAPE,R) 

HY | 

STAGE(TAPE, HD> , E, VSN=IMSLIB) 

peJ 

REWIND(TAPE) 

UPDATE(P=TAPE, F, D, 8, L=DUMMY, *=/, L=7) 
REWIND (TAPE) 

SKIPF(TAPE ,4,17) 

UPDATE(P=TAPE, F, D, 8, FDUMMY, *=/, R, L=7) 
REWIND(TAPE) 

SKIPF(TAPE, 5,17) 

COPYBF(TAPE, OUTPUT, 1) 

6/7/8/9 

Step 2. Install IMSL 6 
Installation characteristics are: 

• Permanent file name = IMSLIB 

• Public access (ID=PUBLIC) 

JOB. 1 

ACCOUNT**, *, *, *) | (Supplied by user.) 
FILE(TAPE,RT=S) 

LABEL(TAPE, R) 

HY I 

STAGE(TAPE, |HD> , E, VSN=IMSLIB) 

(peJ 

R E WIND(TAPE) 

UPDATE(P=TAPE, F, D, 8, *=/, C=PUNCH) 
COMMENT. * INSTALLATION DECK ON PUNCH** 
7/8/9 

/IDE NT IMS L (Optional.) 

/DEFINE SCOPE 2 (Required.) 


Note that one of the following three tape parameters is 
required. 

/DEFINE MT (7-track, 800 bpi.) 

/DEFINE NT (9-track, 800 bpi.) 

/DEFINE NTPE (9-track, 1600 bpi.) 

/DELETE IMSLIL.XX, YY (Required.) 

JOB. 

ACCOUNTS, *,*,*) 

6/7/8/9 
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Step 3. Run Verification Tests 


Note that one of the following three tape parameters is 
required. 


Refer to the following: 

JOB. \ 

ACCOUNT(*, *, *, *) } (Supplied by user.) 
FILE(TAPE, RT=S) 

LABEL(TAPE,R) 

HY | 

STAGE (TAPE, | HD > , E,VSN=IMSLIB) 

Ipe J 

REWIND (TAPE) 

SKIPF(TAPE, 4,17) 

UPDATE(P=TAPE, F,D,8, *=/,R=C, C=PUNCH) 
COMMENT. **VERIFY DECK ON PUNCH** 
7/8/9 

/IDENT IMSL (Optional.) 

/DEFINE SCOPE 2 (Required.) 


/DEFINE MT (7-track, 800 bpi.) 

/DEFINE NT (9-track, 800 bpi.) 

/DEFINE NTPE (9-track, 1600 bpi.) 

/DELETE IMSLV1. XX, YY (Required.) 

JOB. | 

ACCOUNT(*, *, *, *) j (Supplied by user.) 
6/7/8/9 

Step 4. Verification 

Do a minimal visual comparison of the expected verify 
output and the actual verify output. 


''4 
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RELEASE DESCRIPTION 


INSTALLATION PROCEDURES 


SIMSCRIPT 1.5 runs under the SCOPE 2.1 operating 
system. In order to compile the SIMSCRIPT compiler, 
an absolute executable SIMSCRIPT compiler must be in¬ 
stalled in the system. The FORTRAN library is necessary 
for execution of SIMSCRIPT programs. 


HARDWARE REQUIREMENTS 


SIMSCRIPT 1.5 is installed by executing deck SIMINS or 
SIMGEN contained on the first file of tape SIMREL: 

SIMINS Catalogs binaries as SIMLEL 

(ID=SCPSCR) and SIMLIB7 (ID=PRDLIB). 

SIMGEN Regenerates SIMSCRIPT and catalogs 

SIMLEL (ID=SCPSCR) and SIMLIB7 
(ID-PRDLIB). 


SIMSCRIPT I. 5 requires the same minimum hardware 
configuration as SCOPE 2.1. 


DEFICIENCIES 

None. 


RELEASE MATERIALS 


SIMSCRIPT 1.5 resides on the tape known as SIMREL. 
SIMREL is a 7- or 9-track tape with the following charac¬ 
teristics: labeled, 800 bpi, odd parity, BT=I, RT=W, 
MBL=5120 and SIMREL*SCP2.1 as the file identifier in 
the HDR1 label. 


The installation decks can be retrieved from tape SIMREL 
through the following procedure. 


EXTR, T20, 


SM 

SN 


, STGGG. 


ACCOUNT. 

LABEL(OLDPL, L=$SIMREL*SCP2.1$) 
(HY 


STAGE(OLDPL, PRE, 


HD 


, E, VSN-SIMRE L) 


UPDATE (Q, C=PUNCH , D, 8) 

COMMENT. ^INSTALLATION DECKS ON PUNCH** 

7/8/9 

*DF X 

*C Y 

7/8/9 

G/7/8/9 


where X is HY or HD and Y is SIMINS or SIMGEN. 


Partition 1 - installation and verification decks in 
UPDATE PL form, 

Partition 2 - source code of the SIMSCRIPT compiler 
and execution library in UPDATE PL form, 

Partition 3 - absolute overlay of the SIMSCRIPT com¬ 
piler, and 

Partition 4 - relocatable binaries of the SIMSCRIPT 
execution library. 


Listings of the installation decks (SIMINS and SIMGEN) 
and the verification deck (VSIMI5) may be obtained from 
tape SIMREL by executing the following job: 


LIST, T20, 


[ SM 
I SN 


, STGGG. 


ACCOUNT. 

LABEL(OLDPL, L=$SIMREL*SCP2.1$) 
(HY 


STAGE(OLDPL, PRE, 


HD 


, E, VSN=SIMREL) 


UPDATE(F, L=7) 

7/8/9 

6/7/8/9 


VERIFICATION PROCEDURE 


The verification deck can be retrieved from tape SIMREL 
through the following procedure: 


VERIFY, T20, 


SM 

SN 


,STGGG. 


STAGE(OLDPL, PRE, 


,E,VSN=SIMREL) 


ACCOUNT. 

LABEL(OLDPL, L=$SIMREL*SCP2.1$) 

{HY} 

(hdJ 

UPDATE(Q, C-PUNCH, D, 8) 

COMMENT. **VERIFY DECK ON PUNCH** 

7/8/9 

*C VSIMI5 

7/8/9 

6/7/8/9 


SIMSCRIPT 1.5 can be verified by executing the deck 
VSIMI5. 
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CONFIGURATION PARAMETERS 


NOTES AND CAUTIONS 


The installation jobs, SIMINS and SIMGEN, do not purge 

The following installation parameter is in common deck currently existing SIMSCRIPT permanent files. 

CDC$, which also contains the SIMSCRIPT assembly 
parameters: 

Parameter Released Default Value Significance 


= LINES EE 


55 


10 


Number of lines per 
page 
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ACOUNTX file 1-14-1, II-14-1 
alpha string request 1-13-4, II-13-4 
ANEWSYS file 1-3-1 
AOVFIX parameter 1-3-4 

APEX-III Matrix Reduction Option (REDUCE) 1-2-3, 
II-2-3, III—2—3 

APEX-III Mixed Integer Programming Option (MIP) 
1-2-2, II—2—2, III-2-2 

APEX-III Out-Of-Core System 1 1-2-1, II-2-1, III-2-1 

APEX-III Parametrics Option 1-2-4, II-2-4, III-2-4 

APEX-III Usage Package 1 1-2-5, II-2-5 

APEXCV deck II-2-1, III-2-1 

APEXC1 deck 1-2-1, II-2-1, III-2-1 

APEXMV verification deck 1-2-3, II-2-2, III-2-3 

APEXOV file 1-2-1, II-2-1, III-2-1 

APEXPL file 1-2-1, II-2-1, III-2-1 

APEXPV verification deck 1-2-4, II-2-4, III-2-5 

APEXRL file 1-2-1, II-2-1, III-2-1 

APEXRV verification deck 1-2-3, II-2-3, III-2-4 

APEXUV verification deck 1-2-5, II-2-5 

APEXU1 installation deck 1-2-5, II—2—5 

APL loader 1-3-5 

APL 2 1-3-1 

APLDEBG file 1-3-1 

APLINST file 1-3-6 

APLLIB file 1-3-6 

APLOVLS file 1-3-6 

APLPL file 1-3-1 

APLPROD file 1-3-1 

APLWS file 1-3-6 

APT IV 2 1-4-1, II-3-1, III—3—1 

ATB1 file 1-12-1, II-12-1 

ATB2 file 1-12-1, II-12-1 

ATB3 file 1-12-1, II-12-1 

ATPLT file 1-12-1, II-12-1 

ATRB file 1-12-1, II-12-1 

AUADTF file 1-14-3, II-14-4 

AUAPTF file 1-14-3, II-14-4 

CATDEMOS parameter II-8-2 
CDC$ deck III-5-2 
CGTPP file II-8-1 
CHANGE directive 1-3-4 
COMPILE file II-6-1 
COMPLEX deck II-3-2 
CPU model mode 1-14-1, II-14-1 
CP64 installation option 1-5-2 
CRM installation option 1-5-2 
CYB176 directive II-2-2, II-2-6 

DATA statement 1-13-2, II-13-2 
DATBAS file 1-11-1, II-ll-l 
DATBASE file 1-11-2 
DBFMT file 1-11-1, II-ll-l 
DBGEN file 1-11-1, II-ll-l 
DBRCV file 1-11-1, II-ll-l 


decks 

APEXCV II—2—1, III—2 — 1 
APEXC1 1-2-1, II-2-1, III—2 — 1 
APEXMV verification 1-2-3, II-2-2, III-2-3 
APEXPV verification 1-2-4, II-2-4, III-2-5 
APEXRV verification 1-2-3, II-2-3, III-2-4 
APEXUV verification 1-2-5, II—2—5 
APEXU1 installation 1-2-5, II—2—5 
CDC$ III—5—2 
COMPLEX II-3-2 
GPSSTXT 1-5-3, II—4—3 
GPS1 installation 1-5-1, II—4—1 
GPS2 installation 1-5-1, II-4-1 
INSTALL II—8—1 
LCCDATA II-3-2 
MAPT41 installation 1-4-2, III-3-2 
MAPT42 installation 1-4-2, III-3-2 
MAPT43 installation 1-4-2, III-3-2 
MAPT44 installation 1-4-2, III-3-2 
MAPT45 installation 1-4-2, III-3-2 
MAPT46 installation 1-4-2, III-3-2 
MAPT47 load 1-4-2,111-3-2 
MAPT48 verification 1-4-3, III—3—2 
MAPT49 verification 1-4-3, III-3-3 
MAPT50 verification 1-4-3, III—3—3 
SIMGEN III—5—1 
SIM INS III-5-1 
SIMI51 II—9—1 
SIMI52 II—9—1 
SOURCDK II—3—2 
UNP 1-13-1, II—13—1 
VGPS verification 1-5-1 
VS I MI 5 II-9-1, III—5—1 

DEFINE file 1-11-1, II-ll-l 
DEMOl program II-8-5 
DEM02 program II-8-5 
DEM03 program II-8-5 
DEM04 program II-8-5 
device mode request 1-13-4, II—13—4 
DEVLIST subroutine 1-13-2, II-13-2 
DFTMP file 1-14-4, II-14-4 
directives 

CHANGE 1-3-4 

CYB176 II-2-2, II—2 — 6 

FULL 1-3-1 

FULLCOR 1-3-1 

HD 1-2-1, 1-2-6, II—2—1, II—2—6 

LIBEDIT 1-3-5 

MIP 1-2-2, II—2—1, III-2-2 

MT 1-2-1, 1-2-6, II-2-1, II-2-6, III-2-2 

NOENTRY 1-3-4 

NT III—2—2 

PAR 1-2-2, II-2-2, III—2—2 
PE 1-2-1, 1-2-6, II—2—1, II—2—6 
PF 1-2-6, II-2-6 
RED 1-2-2, II-2-1, III—2—2 
UPDATE 1-4-2, III-3-2 
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documentation I-1-1, II-1-1, III-1-1 
DUMPF utility file 1-14-4, II-14-4 
EDITLIBPP parameter II-8-2 
EXTRACT file 1-3-2 


GPSS V/6000 1.2 1-5-1, II-4-1 

GPSSTXT deck 1-5-3, II-4-3 
GPS1 installation deck 1-5-1, II-4-1 
GPS2 installation deck 1-5-1, II-4-1 


FILELOAD installation option 1-5-2 
files 

ACOUNTX 1-14-1, II-14-1 
ANEWSYS 1-3-1 
APEXOV 1-2-1, II-2-1, III—2—1 
APEXPL 1-2-1, II-2-1, III—2—1 
APEXRL 1-2-1, II-2-1, III—2—1 
APLDEBG 1-3-1 
APLINST 1-3-6 
APLLIB 1-3-6 
APLOVLS 1-3-6 
APLPL 1-3-1 
APLPROD 1-3-1 
APLWS 1-3-6 
ATB1 1-12-1, II-12-1 
ATB2 1-12-1, II-12-1 
ATB3 1-12-1, II-12-1 
ATPLT 1-12-1, II-12-1 
ATRB 1-12-1, II-12-1 
AUADTF 1-14-3, II-14-4 
AUAPTF 1-14-3, II-14-4 
CGTPP II-8-1 
COMPILE II-6-1 
DATBAS 1-11-1, II-ll-l 
DATBASE 1-11-2 
DBFMT 1-11-1, II-ll-l 
DBGEN 1-11-1, II-ll-l 
DBRCV 1-11-1, II-ll-l 
DEFINE 1-11-1 
DFTMP 1-14-4, II-14-4 
DUMPF utility 1-14-4, II-14-4 
EXTRACT 1-3-2 
IAFMODS TEXT 1-3-7 
IMSLIB II-5-1 
MINIT 1-13-1, II—3—2 
MOVLIB 1-11-2 
NEWSF 1-3-7 
PFTMP 1-14-4, II-14-4 
POSTLGO 1-13-2, II-13-2 
RANDR 1-14-1, II—14—1 
SEGLIB 1-10-4 
TAPLOUT 1-3-6 
TAPLTST 1-3-6 
TOTAL 1-11-1, II-ll-l 
TOTALE 1-11-2 
TOTUTIL 1-11-3 
UAPEXOV 1-2-6, II-2-6 
UAPEXPL 1-2-6, II-2-6 
UAPEXRL 1-2-6, H-2-6 
UAPEX3 H-2-5 
UAUINS 1-14-1, II-14-1 
UNIPLOT 1-13-2, II-13-2 
UNIPOST 1-13-2, H-13-2 
usage detail 1-14-3, II-14-3 
USER 1-9-1 
VALIDUx 1-14-3 
VRFY 1-7-2, II-6-2, II-10-3 
5LPLOTF 1-13-3, II-13-3 
FPRM array 1-13-3, II-13-3 
FTRACE installation option 1-5-2 
FULL directive 1-3-1 
FULLCOR directive 1-3-1 


HD directive 1-2-1, 1-2-6, II-2-1, II-2-6 

IAFMODS TEXT file 1-3-7 
IGSDBUG parameter II-8-2 
IMSL 6 1-6-1, II-5-1, III—4—1 

IMSLIB file II-5-1 
IMUL installation job 1-5-2 
increment request 1-13-5 
INSTALL deck II-8-1 
INTERCOM 4 II-8-1 

IPRM array 1-13-3, II-13-3 
IREQ array 1-13-3, II-13-3 

K statement 1-8-2, II—7—2 

LCCDATA deck II-3-2 
LCGT/IGS 2 1-7-1, II-6-1 

LCGTVR2 user library 1-7-1, II-6-1 
LIBEDIT directive 1-3-5 
=LINES= parameter III—5—2 
LISALL installation option 1-5-2 

MAPT41 installation deck 1-4-2, III—3—2 
MAPT42 installation deck 1-4-2, III-3-2 
MAPT43 installation deck 1-4-2, III-3-2 
MAPT44 installation deck 1-4-2, III—3—2 
MAPT45 installation deck 1-4-2, III—3—2 
MAPT46 installation deck 1-4-2, III—3—2 
MAPT47 load deck 1-4-2, III-3-2 
MAPT48 verification deck 1-4-3, III—3—3 
MAPT49 verification deck 1-4-3, III-3-3 
MAPT50 verification deck 1-4-3, III—3—3 
MAXDEV variable 1-13-2, II-13-2 
MINIT file 1-13-1, II-13-2 
MIP directive 1-2-2, II-2-1, III-2-2 
MOVLIB file 1-11-2 

MT directive 1-2-1, 1-2-6, II-2-1, II-2-6, III-2-2 

NAM/IAF communications packages I-10-1 
NEWPEN request 1-13-4, II-13-4 
NEWSF file 1-3-7 
NOENTRY directory 1-3-5 
NPFDATA subroutine 1-13-3, II-13-3 
NT directive III—2—2 

PAR directive 1-2-2, II-2-2, III-2-2 

parametric and sculptured mode 1-4-1, II-3-1, III—3— 1 

parametric surface mode 1-4-1, III—3—1 

PE directive 1-2-1, II-2-1, 1-2-6, II-2-6 

pen restore request 1-13-5 

PERT/TIME 2 1-8-1, II-7-1 

PF directive 1-2-6, II-2-6 

PFTMP file 1-14-4, II-14-4 

POSTLGO file 1-13-2, II-13-2 

/PREO/labeled common block 1-13-2, II-13-2 

RANDR file 1-14-1, II-14-1 
RED directive 1-2-2, II-2-1, III-2-2 
release tapes/program libraries 
AP001B II-14-1 
AP001N 1-14-2 


Index-2 


76071100 N 



A3CREL III—2“ 1 
IMSLREL III—4—1 
MIPREL HI-2-2 
PARREL III—2—4 

PL27 II-9-1 
PL35 H-4-1 
PL40 II-8-1 
PL41 n-8-3 
PL45 H-2-1 
PL46 H-8-5 
PL47 R-8-6 
PL49 n-ii-i 
PL51 R-2-2 
PL52 II-2-3 
PL53 R-2-4 
PL59 1-4-2, III—3—1 
PL59A II-3-1 
PL62 R-12-1 
PL67 R-6-1 
PL71 R-13-1 
PL84 H-2-6 
PL85 E-7-1 
PL86A II-10-1 
PL86B II-lO-l 
PL86C II-10-7 
PL87 H-5-1 
REDREL III-2-4 
REL50 1-5-1 
REL52A 1-8-1 
REL53 1-9-1 
REL54A 1-11-1 
REL54B 1-11-2 
REL54C 1-11-3 
REL54D 1-11-4 
REL56A 1-7-1 
REL57B 1-2-1 
REL57C 1-2-2 
REL57D 1-2-3 
REL57E 1-2-4 
REL57F 1-2-5 
REL58 1-12-1 
REL59 1-13-1 
REL60 1-3-2 
REL61 1-15-1 
REL62 1-10-1 
REL63 1-6-1 
SIMREL III-5-1 
reorigin request 1-13-4, II-13-4 
REPRIEVE installation option 1-5-2 

Sanders Graphic 7 Post Processor Option 11-10-7 

sculptured surfaces mode 1-4-1, II-3-1, III—3—1 

SEGLIB file 1-10-4 

SIMGEN installation deck III-5-1 

SIM INS installation deck III-5-1 

SIMI51 installation deck II-9-1 

SIMI52 installation deck II-9-1 

SIMSCRIPT I. 5 3 1-9-1, R-9-1, III-5-1 

SOURCDK deck II-3-2 

standard mode 1-4-1, II-3-1, III—3—1 

SYMBOL subroutine 1-13-4, II-13-4 

SYSEDIT option 1-9-1 

r 


TAPLOUT file 1-3-6 
TAPLTST file 1-3-6 

Tektronix 4010/4014 Terminals 1-10-7, n-8-3, n-10-7 
Tektronix 401X Post Processor Option II-10-1 
TGR7LIB library n-10-8 
TGR7SFL library II-10-8 

threshold protection indicator 1-14-1, n~14-l 
TIGS 1 1-10-1, II-10-1 

TIGSLIB library 1-10-1, H-10-2 
TIGSSFL library 1-10-1, II-10-2 
TOTAL file 1-11-1, II-ll-l 
TOTAL Universal Extended 1 1-11-2 

TOTAL Universal Extended 2 1-11-4 

TOTAL Universal 1 I-11-1, II-11-1 

TOTAL Universal 2 1-11-3 

TOTAL/ATHENA' 1-12-1, II-12-1 
TOTALE file 1-11-2 
TRANEX user number 1-11-2 

UAFINS job 1-14-3, II-14-3 
UAPEXOV file 1-2-6, II-2-6 
UAPEXPL file 1-2-6, H-2-6 
UAPEXRL file 1-2-6, H-2-6 
UAPEX3 file II-2-5 
UAUINS fUe 1-14-1, II-14-1 
UNIPLOT file 1-13-2, II-13-2 
UNIPLOT 2 1-13-1, II-13-1 

UNIPOST file 1-13-2, H-13-2 
UNIPOST postprocessor 1-13-1, II-13-1 
UNP deck 1-13-1, II-13-1 
UPDATE directive 1-4-2, III-3-2 
Usage Accounting Utility 1-14-1, II-14-1 
usage detail files 1-14-3, II-14-3 
USER file 1-9-1 

VALIDUx file 1-14-3 
vector request 1-13-4, H-13-4 
VGPS verification deck 1-5-1 
VOUGHT parameter n-8-2 
VRFY file 1-7-2, II-6-2, H-10-3 
VSIMI5 verification deck H-9-1, III-5-1 

XEDIT 3 1-15-1 

XJOB installation option 1-5-2 

Z statement 1-8-2, II-7-2 

103A modem 1-7-1, II-6-1 
1700 IMPORT II—8—1 

5LPLOTF file 1-13-1, II-13-3 

777/IGS (HOST) II-8-1 
777/IGS (REMOTE) II-8-2 
777/IGS Products II-8-1 
777/IGS with 3D H-8-1 
777/IGS with 3D (HOST) II-8-5 
777/IGS with 3D (REMOTE) H-8-6 
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